Compartir a través de


Configuración de tools.ini

El archivo tools.ini contiene información para inicializar los depuradores de línea de comandos. Al iniciarse, 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 espacios 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. Cualquier otra cosa es TRUE.

Entrada Descripción

$u 0:value ... $u 9:value

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. Sin equivalente de línea de comandos.

DepurarChildren:flag

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:flag

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:file

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 la línea de comandos es -cf. Para obtener más información, consulte Uso de archivos de script.

LazyLoad:flag

TRUE o FALSE. Si es TRUE, CDB realiza la carga diferida de símbolos; es decir, los símbolos no se cargan hasta que sea necesario. El equivalente de la 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:filename

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 la 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:flag

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 la línea de comandos es -g.

StopOnProcessExit:flag

TRUE o FALSE. Si es TRUE, CDB se detiene cuando recibe una notificación de terminación del proceso. El equivalente de la 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 siguientes maneras:

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

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

VerboseOutput:flag

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 la línea de comandos es -v.

lines:flag

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

srcopt:options

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

srcpath:directory

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

enable_unicode:flag

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

force_radix_output:flag

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

col_mode:flag

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 coloreado. 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:namecolspec

El nombre indica el elemento que está coloreando. La colspec es un indicador RGB de tres letras con la forma [rR-][gG-][bB-]. Una letra minúscula indica más oscuro, una letra mayúscula indica más brillante y un guión indica que no hay contribución de componente de color. Debido a las limitaciones del color de la consola, el brillo no es realmente por componente, pero se aplica a todos los componentes si hay alguna solicitud brillante. En otras palabras, rgB es igual que RGB. Por este motivo, se recomienda usar 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