Configuración de tools.ini

  • Artículo

El archivo tools.ini contiene información para inicializar los depuradores de línea de comandos. Al iniciar, el depurador busca el encabezado de sección adecuado en el archivo tools.ini y extrae información de inicialización de las entradas bajo el encabezado . Cada depurador de línea de comandos tiene su propio encabezado de sección: [CDB], [NTSD] y [KD]. La variable de entorno INIT debe apuntar al directorio que contiene el archivo tools.ini.

WinDbg no usa el archivo tools.ini. En su lugar, WinDbg guarda la configuración de inicialización en áreas de trabajo.

Las entradas tools.ini se muestran en la tabla siguiente.

Las palabras clave deben estar separadas de los valores por espacio en blanco o dos puntos. En las palabras clave no se distingue entre mayúsculas y minúsculas.

Para los valores TRUE o FALSE , "FALSE" es el único valor false. Todo lo demás es TRUE.

Entrada Descripción

$u 0: valor ... $u 9: valor

Asigne valores a alias de nombre fijo. Puede especificar valores numéricos n o 0xn o cualquier otra cadena. Consulte Uso de alias para obtener más información. No hay equivalente de línea de comandos.

DepurarChildren: marca

TRUE o FALSE. Si es TRUE, CDB depura la aplicación especificada, así como cualquier proceso secundario que pueda generar. El equivalente de línea de comandos es -o.

DepurarOutput: marca

TRUE o FALSE. Si es TRUE, CDB envía la salida y recibe la entrada a través de un terminal. Si es FALSE, la salida va a la pantalla del usuario. La opción de línea de comandos -d es similar pero no idéntica.

IniFile: archivo

Especifica el nombre del archivo de script del que CDB o KD toma comandos en el inicio. El valor predeterminado es el archivo ntsd.ini en el directorio actual. El equivalente de línea de comandos es -cf. Para obtener más información, consulte Uso de archivos de script.

LazyLoad: marca

TRUE o FALSE. Si es TRUE, CDB realiza la carga de símbolos diferidos; es decir, los símbolos no se cargan hasta que sea necesario. El equivalente de línea de comandos es -s.

Para obtener más información y otros métodos para establecer esta opción, vea Carga diferida de símbolos.

SetDll: nombre de archivo

Establezca el archivo DLL de extensión. Se debe omitir la extensión .dll nombre de archivo. El valor predeterminado es userexts.dll. El equivalente de línea de comandos es -a.

Para obtener más información y otros métodos para establecer este valor predeterminado, consulte Carga de archivos DLL de extensión del depurador.

StopFirst: marca

TRUE o FALSE. Si es true, CDB se detiene en el punto de interrupción al final del proceso de carga de imágenes. El equivalente de línea de comandos es -g.

StopOnProcessExit: marca

TRUE o FALSE. Si es TRUE, CDB se detiene cuando recibe una notificación de terminación del proceso. El equivalente de línea de comandos es -G.

sxd: eventsxe: event

Establece la respuesta del depurador y el estado de control de la excepción o evento especificados.

Las excepciones y eventos se pueden especificar de las maneras siguientes:

*: excepción predeterminada n: excepción n (decimal) 0xn: excepción 0xn (hexadecimal) (otro): código de evento

Consulte Control de excepciones y eventos para obtener más información sobre este proceso y para otros métodos de control de esta configuración.

VerboseOutput: marca

TRUE o FALSE. Si es TRUE, CDB mostrará información detallada sobre el control de símbolos, la notificación de eventos y otras repeticiones en tiempo de ejecución. El equivalente de línea de comandos es -v.

líneas: marca

TRUE o FALSE. La marca de líneas habilita o deshabilita la compatibilidad con la información de la línea de origen.

srcopt: opciones

Establece las opciones de línea de origen que controlan la visualización de código fuente y las opciones de paso a paso del programa. Para obtener más información, vea l+, l- (Establecer opciones de origen).

srcpath: directorio

Establece la ruta de acceso de búsqueda del archivo de origen. Para obtener más información, vea .srcpath, .lsrcpath (Establecer ruta de acceso de origen).

enable_unicode: marca

TRUE o FALSE. La marca enable_unicode especifica si el depurador muestra punteros y matrices de USHORT como cadenas Unicode.

force_radix_output: marca

TRUE o FALSE. La marca force_radix_output especifica si los enteros se muestran en formato decimal o en el radix predeterminado.

col_mode: marca

TRUE o FALSE. La marca col_mode controla la configuración del modo de color. Cuando el modo de color está habilitado, el depurador puede generar una salida de color. De forma predeterminada, la mayoría de los colores no se establecen y, en su lugar, tienen como valor predeterminado los colores de la consola actual.

col: name colspec

El nombre indica el elemento que está coloreando. La colspec es un indicador RGB de tres letras de la forma [rR-][gG-][bB-]. Una letra en minúsculas indica más oscuro, una letra mayúscula indica más brillante y un guión no indica ninguna contribución de componente de color. Debido a las limitaciones del color de la consola, bright no es realmente por componente, pero se aplica a todos los componentes si alguna solicitud es brillante. En otras palabras, rgB es el mismo que RGB. Por este motivo, se recomienda que se usen todos los límites si se van a usar mayúsculas.

Ejemplo de uso:

col: emphfg R--

A continuación se muestra una sección de ejemplo [NTSD] del archivo tools.ini:

[NTSD]
sxe: 3c
sxe: cc
$u0: VeryLongName
VerboseOutput:true