Comandos de la 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 parámetro, muestra la configuración actual del modo detallado. |
simpatizar [Ruta] |
Establece la ruta de acceso de búsqueda de símbolos. Sin 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 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. |
renunciar |
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.
| Get-Help | Efecto |
|---|---|
cargar archivo |
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ón base |
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.
| Get-Help | Efecto |
|---|---|
findexe File Path |
Busca el archivo ejecutable especificado en la ruta de acceso especificada mediante la rutina FindExecutableImage . |
finddbg File Path |
Busca el archivo .dbg especificado en la ruta de acceso especificada. Incluir la extensión .dbg es opcional. |
Ruta de acceso del archivo dir |
Busca el archivo especificado en la ruta de acceso especificada o en cualquier subdirectorio de esta ruta de acceso mediante la rutina EnumDirTree . |
srchtree Path File |
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 dir, salvo que los parámetros se invierten. |
Archivo ffpath |
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 |
|---|---|
mod Address |
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. |
epmod PID |
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. |
obj Mask |
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; vea Sintaxis de caracteres comodín de cadena para obtener más información. |
src Mask |
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; vea 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 |
|---|---|
enum Module!Símbolo |
Enumera todos los símbolos que coinciden con el módulo y el símbolo especificados. El módulo 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; vea Sintaxis de caracteres comodín de cadena para obtener más información. |
dirección enumaddr |
Enumera todos los símbolos asociados a la dirección especificada. |
addr Address |
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 dirección siguiente |
Muestra información detallada sobre el siguiente símbolo después del símbolo o la 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 dirección previa |
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. |
line File#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; estos deben estar separados con un signo de número ( # ). |
srclines File 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; estos deben estar separados 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 las variables locales que coinciden con el patrón especificado; vea Sintaxis de caracteres comodín de cadena para obtener más información. |
type TypeName |
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; vea 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, prefijo 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 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, se usará el subdirectorio simbólico del directorio principal para el almacén de bajada. Sin ningún parámetro, home muestra el directorio principal actual. |
srvpath Path |
Comprueba si la ruta de acceso especificada es la ruta de acceso de un almacén de símbolos. |
Srvind File |
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. |
fii File |
Muestra los índices del servidor de símbolos para el archivo binario especificado y sus archivos asociados. |
Getfile File Index |
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. Index 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. |
sup Path 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 a su vez se usa para determinar el archivo que se almacena. |
storeadd File Store |
Agrega el archivo especificado al almacén de símbolos especificado. El almacén 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 |
|---|---|
undec Name |
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. |
agregar tamañ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 en comandos DBH posteriores, hasta que la sesión de DBH finalice 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. |
del Name del Address |
Elimina un símbolo imaginario agregado previamente 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. |