Comandos DBH

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.

Get-Help	Efecto
verbose [on|off]	Activa o desactiva el modo detallado. Sin ningún parámetro, muestra la configuración actual del modo detallado.
simpatía [Ruta]	Establece la ruta de acceso de búsqueda de símbolos. Sin ningún parámetro, muestra la ruta de búsqueda de símbolos actual.
Opciones de symopt symopt +Options symopt -Options symopt	Establece las opciones de símbolo. + Sin o -, el valor de Options reemplaza las opciones de símbolos actuales. Si + se usa o - , Options especifica las opciones que se van a agregar o quitar; debe haber un espacio antes + de o - pero sin espacio después de él. Sin ningún parámetro, se muestran las opciones de símbolo actuales. Cuando se inicia DBH, el valor predeterminado de todas las opciones de símbolo es 0x10C13. Para obtener una lista de las opciones disponibles, consulte Configuración de opciones de símbolos.
help	Muestra el texto de ayuda de los comandos DBH.
Dejar	Sale del programa DBH.

En la tabla siguiente se enumeran los comandos que cargan, descargan y vuelven a base el 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.

Get-Help	Efecto
cargararchivo	Carga el módulo especificado. El archivo debe especificar la ruta de acceso, el nombre de archivo y la extensión de nombre de archivo del archivo ejecutable o del archivo de símbolos.
Descargar	Descarga el módulo actual.
direcciónbase	Establece la dirección base predeterminada en el valor especificado. Todas las direcciones de símbolos 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.

Get-Help	Efecto
findexeFile Path	Busca el archivo ejecutable especificado en la ruta de acceso especificada mediante la rutina FindExecutableImage .
ruta de acceso del archivofinddbg	Busca el archivo .dbg especificado en la ruta de acceso especificada. Incluir la extensión .dbg es opcional.
Ruta de acceso del archivodir	Busca el archivo especificado en la ruta de acceso especificada o en cualquier subdirectorio de esta ruta de acceso mediante la rutina EnumDirTree .
Archivo de ruta de accesode srchtree	Busca el archivo especificado en la ruta de acceso especificada o en cualquier subdirectorio de esta ruta de acceso mediante la rutina SearchTreeForFile . Este comando es el mismo que el dir, excepto que se invierten los parámetros.
Archivo de ruta de acceso	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.

Get-Help	Efecto
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 especifica el identificador de proceso del proceso deseado.
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. La máscara puede contener una variedad de caracteres comodín y especificadores; consulte Sintaxis de caracteres comodín de cadena para obtener más información.
máscara de src	Enumera todos los archivos de origen asociados al módulo predeterminado que coinciden con el patrón especificado. La máscara puede contener una variedad de caracteres comodín y especificadores; consulte Sintaxis de caracteres comodín de cadena para obtener más información.
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.

Get-Help	Efecto
enumModule!Símbolo	Enumera todos los símbolos que coinciden con el módulo y el símbolo especificados. Module especifica el módulo que se va a buscar (sin la extensión de nombre de archivo). Symbol especifica un patrón que debe contener el símbolo. Tanto Module como Symbol pueden contener una variedad de caracteres comodín y especificadores; consulte Sintaxis de caracteres comodín de cadena para obtener más información.
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!] Símbolo	Muestra información detallada sobre el símbolo especificado. Se puede incluir un especificador de módulo opcional. No se deben usar caracteres comodín, ya que si varios símbolos coinciden con el patrón, el nombre solo muestra el primero de ellos.
next [Module!] Símbolo siguientedirección	Muestra información detallada sobre el símbolo siguiente después del símbolo o dirección especificados. Si se especifica un símbolo por nombre, se puede incluir un especificador de módulo opcional, pero no se deben usar caracteres comodín.
prev [Module!] Símbolo prevAddress	Muestra información detallada sobre el primer símbolo anterior al símbolo o dirección especificados. Si se especifica un símbolo por nombre, se puede incluir un especificador de módulo opcional, pero no se deben usar caracteres comodín.
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 especifica el nombre del archivo de origen y LineNum especifica el número de línea dentro de ese archivo; se deben separar con un signo de número ( # ).
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 especifica el nombre del archivo de origen y LineNum especifica el número de línea dentro de ese archivo; se deben separar con un espacio.
dirección laddr	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.
función locals [Mask]	Muestra todas las variables locales contenidas en la función especificada. Si se incluye Mask , solo se muestran los locales que coinciden con el patrón especificado; consulte Sintaxis de caracteres comodín de cadena para obtener más información.
typeTypeName	Muestra información detallada sobre el tipo de datos especificado. TypeName especifica el nombre del tipo de datos (por ejemplo, WSTRING). Si ningún nombre de tipo coincide con este valor, se mostrará cualquier símbolo coincidente. A diferencia de la mayoría de los parámetros de comando de DBH, TypeName distingue mayúsculas de minúsculas.
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 especifica el nombre del archivo de origen, incluida la ruta de acceso absoluta y la extensión de nombre de archivo. Obj especifica el nombre del archivo de objeto, incluida la ruta de acceso relativa y la extensión de nombre de archivo. Tanto Source como Obj pueden contener una variedad de caracteres comodín y especificadores; consulte Sintaxis de caracteres comodín de cadena para obtener más información. 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, anteponga el nombre de archivo con </strong> para indicar una ruta de acceso comodín.
valor de índice	Muestra información detallada sobre el símbolo con el valor de índice especificado.
dirección de ámbito ámbito [Module!] Símbolo	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 especifica el nombre del símbolo. 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 especifica la dirección hexadecimal de un símbolo que se va a usar como elemento primario para la búsqueda. Tag especifica el valor del clasificador de tipo de símbolo hexadecimal (SymTagXxx) que debe coincidir con el símbolo. Address especifica la dirección del símbolo. Si se incluyen los globales , solo se mostrarán símbolos globales.
Dirección de uw	Muestra la información de desenredado de la función en la dirección especificada.
Dtag	Muestra todos los valores del clasificador de tipos de símbolos (SymTagXxx).
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.

Get-Help	Efecto
home [Path]	Establece el directorio principal usado por SymSrv y SrcSrv para el almacén de bajada predeterminado. Si la ruta de acceso de símbolo contiene una referencia a un servidor de símbolos que usa un almacén de bajada predeterminado, el subdirectorio simbólico del directorio principal se usará para el almacén de bajada. Sin ningún parámetro, home muestra el directorio principal actual.
ruta de acceso de srvpath	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. El archivo debe especificar el nombre de archivo y la ruta de acceso absoluta del archivo deseado.
archivo fii	Muestra los índices del servidor de símbolos para el archivo binario especificado y sus archivos asociados.
Índice de archivogetfile	Muestra el archivo con el nombre y el índice de servidor de símbolos especificados. El archivo especifica el nombre del archivo deseado; esto no debe incluir su ruta de acceso. Índice especifica el índice del servidor de símbolos del archivo deseado. DBH usa la rutina SymFindFileInPath para buscar el árbol en la ruta de acceso del símbolo actual de un archivo con este nombre y este índice.
supPath File1 File2	Almacena un archivo en un almacén de símbolos, en función de los valores de los parámetros. Path especifica la ruta de acceso del directorio del almacén de símbolos. File1 y File2 se usan para crear un valor delta, que se usa a su vez para determinar el archivo que se almacena.
storeaddFile Store	Agrega el archivo especificado al almacén de símbolos especificado. Store debe ser la ruta de acceso raíz del almacén de símbolos.

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

Get-Help	Efecto
undecName	Revela el significado de las decoraciones adjuntas al nombre de símbolo especificado. Name puede ser cualquier cadena; no es necesario corresponder a un símbolo cargado actualmente. Si Name contiene decoraciones de C++, se muestra el significado de estas decoraciones.
agregartamaño de dirección de nombre	Agrega el símbolo imaginario especificado a la lista de símbolos cargados en DBH. Name especifica el nombre del símbolo que se va a agregar, Address especifica su dirección hexadecimal y Size su tamaño hexadecimal en bytes. Esto se trata como cualquier otro símbolo de los comandos DBH posteriores, hasta que la sesión de DBH termine con salir o descargar, o hasta que se elimine el símbolo imaginario con del. El archivo de símbolos de destino real no se modifica.
delName delAddress	Elimina un símbolo imaginario que se agregó anteriormente con el comando add . El símbolo se puede especificar por nombre o por dirección. No se puede usar para eliminar símbolos reales.