DBH Commands

Desde la línea de comandos de DBH, puede usar una variedad de comandos para analizar símbolos y archivos de símbolos.

En la tabla siguiente se enumeran los comandos que controlan las opciones de DBH y realizan otras tareas básicas.

Command	Effect
verbose [on|off]	Activa o desactiva el modo detallado. Sin parámetro, muestra la configuración actual del modo detallado.
sympath [Path]	Establece la ruta de acceso de búsqueda de símbolos. Sin parámetro, muestra la ruta de búsqueda de símbolos actual.
symoptOptions symopt +Options symopt -Options symopt	Establece las opciones 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. Sin parámetro, se muestran las opciones de símbolos actuales. Cuando se inicia DBH, el valor predeterminado de todas las opciones de símbolos es 0x10C13. Para obtener una lista de las opciones disponibles, vea Establecer opciones de símbolos.
help	Muestra el texto de ayuda de los comandos DBH.
quit	Sale del programa DBH.

En la tabla siguiente se enumeran los comandos que cargan, descargan y vuelven a base del módulo de destino. Estos comandos no se pueden usar si DBH se inició especificando un identificador de proceso en la línea de comandos.

Command	Effect
loadFile	Carga el módulo especificado. File should specify the path, file name, and file name extension of either the executable file or the symbol file.
unload	Descarga el módulo actual.
baseAddress	Establece la dirección base predeterminada en el valor especificado. Todas las direcciones de símbolo se determinarán en relación con esta dirección base.

En la tabla siguiente se enumeran los comandos que buscan archivos y muestran información de directorio.

Command	Effect
findexeFile Path	Locates the specified executable file in the specified path, using the FindExecutableImage routine.
finddbgFile Path	Busca el archivo .dbg especificado en la ruta de acceso especificada. Incluir la extensión .dbg es 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	Busca el archivo especificado en la ruta de acceso del símbolo actual.

En la tabla siguiente se enumeran los comandos que analizan la lista de módulos y controlan el módulo predeterminado. El módulo predeterminado y su dirección base se muestran en el símbolo del sistema de DBH.

Command	Effect
modAddress	Cambia el módulo predeterminado al módulo con la dirección base especificada.
refresh	Actualiza la lista de módulos.
omap	Muestra las estructuras OMAP del módulo.
epmodPID	Enumera todos los módulos cargados para el proceso especificado. PID specifies the process ID of the desired process.
info	Muestra información sobre el módulo cargado actualmente.
objMask	Enumera todos los archivos de objeto asociados al módulo predeterminado que coinciden con el patrón especificado. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
srcMask	Enumera todos los archivos de origen asociados al módulo predeterminado que coinciden con el patrón especificado. Mask may contain a variety of wildcard characters and specifiers; see String Wildcard Syntax for details.
enummod	Enumera todos los módulos cargados. Siempre hay al menos un módulo, a menos que DBH se ejecute sin un destino, en cuyo caso no hay ninguno.

En la tabla siguiente se enumeran los comandos que muestran y buscan símbolos.

Command	Effect
enumModule!Symbol	Enumera todos los símbolos que coinciden con el módulo y el 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 los símbolos asociados a la dirección especificada.
addrAddress	Muestra información detallada sobre los símbolos asociados a la dirección especificada.
name [Module!]Symbol	Muestra información detallada sobre el 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	Muestra información detallada sobre el siguiente símbolo después del símbolo o la dirección especificados. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
prev [Module!]Symbol prevAddress	Muestra información detallada sobre el primer símbolo anterior al símbolo o dirección especificados. If a symbol is specified by name, an optional Module specifier may be included, but wildcards should not be used.
lineFile#LineNum	Muestra la dirección hexadecimal de la instrucción binaria asociada a la línea de origen especificada y los símbolos asociados a esta línea. También establece el número de línea actual igual al número de línea 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	Muestra los archivos de objeto asociados a la línea de origen especificada y la dirección hexadecimal de la instrucción binaria asociada a esta línea. No cambia el número de línea actual. 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	Muestra el archivo de origen y el número de línea correspondientes al símbolo ubicado en la dirección especificada.
linenext	Incrementa el número de línea actual y muestra información sobre el nuevo número de línea.
lineprev	Disminuye el número de línea actual y muestra información sobre el nuevo número de línea.
localsFunction [Mask]	Muestra todas las variables locales contenidas en la función especificada. If Mask is included, only those locals matching the specified pattern are displayed; see String Wildcard Syntax for details.
typeTypeName	Muestra información detallada sobre el tipo de datos especificado. TypeName specifies the name of the data type (for example, WSTRING). Si ningún nombre de tipo coincide con este valor, se mostrará cualquier símbolo coincidente. Unlike most DBH command parameters, TypeName is case-sensitive.
elines [Source [Obj]]	Enumera todas las líneas de origen que coinciden con la máscara de origen y la máscara de objeto especificadas. 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. Si se omite un parámetro, esto equivale a usar el carácter comodín asterisco (). Si no desea especificar información de ruta de acceso, prefijo el nombre de archivo con </strong> para indicar una ruta de acceso comodín.
indexValue	Muestra información detallada sobre el símbolo con el valor de índice especificado.
scopeAddress scope [Module!]Symbol	Muestra información detallada sobre el elemento primario del símbolo especificado. El símbolo puede especificarse por dirección o por nombre.
srch [mask=Symbol] [index=Index] [tag=Tag] [addr=Address] [globals]	Busca todos los símbolos que coincidan con las máscaras especificadas. Symbol specifies the symbol name. No debe incluir el nombre del módulo, pero puede contener caracteres comodín y especificadores; Consulte Sintaxis de caracteres comodín de cadena para obtener más información. 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	Muestra la información de desenredado de la función en la dirección especificada.
dtag	Displays all the symbol type classifier (SymTagXxx) values.
etypes	Enumera todos los tipos de datos.
dump	Muestra una lista completa de toda la información de símbolos del archivo de destino.

En la tabla siguiente se enumeran los comandos relacionados con los servidores de símbolos y los almacenes de símbolos.

Command	Effect
home [Path]	Establece el directorio principal usado por SymSrv y SrcSrv para el almacén de bajada predeterminado. 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	Comprueba si la ruta de acceso especificada es la ruta de acceso de un almacén de símbolos.
srvindFile	Busca el índice del servidor de símbolos que corresponde al archivo especificado. El índice del servidor de símbolos es un valor único basado en el contenido del archivo, independientemente de si realmente se ha agregado a cualquier almacén de símbolos. File should specify the file name and absolute path of the desired file.
fiiFile	Muestra los índices del servidor de símbolos para el archivo binario especificado y sus archivos asociados.
getfileFile Index	Muestra el archivo con el nombre y el índice de servidor de símbolos especificados. 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	Almacena un archivo en un almacén de símbolos, en función de los valores de los 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	Agrega el archivo especificado al almacén de símbolos especificado. Store should be the root path of the symbol store.

En la tabla siguiente se enumeran los comandos DBH que se aplican a símbolos reales e imaginarios.

Command	Effect
undecName	Revela el significado de las decoraciones adjuntas al nombre de 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	Agrega el símbolo imaginario especificado a la lista de símbolos cargados en 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. El símbolo se puede especificar por nombre o por dirección. No se puede usar para eliminar símbolos reales.