Condividi tramite

Configurazione di tools.ini

  • Articolo

Il file tools.ini contiene informazioni per inizializzare i debugger della riga di comando. All'avvio, il debugger cerca l'intestazione di sezione appropriata nel file tools.ini ed estrae le informazioni di inizializzazione dalle voci sotto l'intestazione. Ogni debugger della riga di comando ha una propria intestazione di sezione : [CDB], [NTSD]e [KD]. La variabile di ambiente INIT deve puntare alla directory contenente il file tools.ini.

WinDbg non usa il file tools.ini. WinDbg salva invece le impostazioni di inizializzazione nelle aree di lavoro.

Le voci tools.ini sono illustrate nella tabella seguente.

Le parole chiave devono essere separate dai valori in base a spazi vuoti o due punti. Le parole chiave non fanno distinzione tra maiuscole e minuscole.

Per i valori TRUE o FALSE , "FALSE" è l'unico valore false. Qualsiasi altra cosa è TRUE.

Movimento Descrizione

$u 0: valore ... $u 9: valore

Assegnare valori agli alias a nome fisso. È possibile specificare valori numerici n o 0xn o qualsiasi altra stringa. Per informazioni dettagliate, vedere Uso degli alias. Nessun equivalente della riga di comando.

DebugChildren: flag

TRUE o FALSE. Se TRUE, CDB esegue il debug dell'applicazione specificata e di qualsiasi processo figlio che potrebbe generare. L'equivalente della riga di comando è -o.

DebugOutput: flag

TRUE o FALSE. Se TRUE, CDB invia l'output e riceve l'input tramite un terminale. Se FALSE, l'output passa alla schermata dell'utente. L'opzione della riga di comando -d è simile ma non identica.

IniFile: file

Specifica il nome del file di script da cui CDB o KD accetta i comandi dall'avvio. Il valore predefinito è il file ntsd.ini nella directory corrente. L'equivalente della riga di comando è -cf. Per informazioni dettagliate, vedere Uso di file di script.

LazyLoad: flag

TRUE o FALSE. Se TRUE, CDB esegue il caricamento di simboli lazy, ovvero i simboli non vengono caricati fino a quando non sono necessari. L'equivalente della riga di comando è -s.

Per informazioni dettagliate e altri metodi di impostazione di questa opzione, vedere Caricamento posticipato dei simboli.

SetDll: filename

Impostare la DLL di estensione. L'estensione del nome file .dll deve essere omessa. Il valore predefinito è userexts.dll. L'equivalente della riga di comando è -a.

Per informazioni dettagliate e altri metodi di impostazione predefinita, vedere Caricamento di DLL dell'estensione del debugger.

StopFirst: flag

TRUE o FALSE. Se true, cdb si arresta sul punto di interruzione alla fine del processo di caricamento delle immagini. L'equivalente della riga di comando è -g.

StopOnProcessExit: flag

TRUE o FALSE. Se TRUE, cdb si arresta quando riceve una notifica di terminazione del processo. L'equivalente della riga di comando è -G.

sxd: eventsxe: event

Imposta la risposta del debugger e lo stato di gestione per l'eccezione o l'evento specificato.

Le eccezioni e gli eventi possono essere specificati nei modi seguenti:

*: eccezione predefinita n: eccezione n (decimale) 0xn: eccezione 0xn (esadecimale) (altro): codice evento

Per informazioni dettagliate su questo processo e per altri metodi di controllo di queste impostazioni, vedere Controllo di eccezioni ed eventi .

VerboseOutput: flag

TRUE o FALSE. Se TRUE, cdb visualizzerà informazioni dettagliate sulla gestione dei simboli, sulla notifica degli eventi e su altre occorrenze di runtime. L'equivalente della riga di comando è -v.

righe: flag

TRUE o FALSE. Il flag di righe abilita o disabilita il supporto per le informazioni sulla riga di origine.

srcopt: opzioni

Imposta le opzioni della riga di origine che controllano le opzioni di visualizzazione del codice sorgente e delle istruzioni del programma. Per altre informazioni, vedere l+, l- (Imposta opzioni di origine).For more information see l+, l- (Set Source Options).

srcpath: directory

Imposta il percorso di ricerca del file di origine. Per altre informazioni, vedere .srcpath, .lsrcpath (Set Source Path).

enable_unicode: flag

TRUE o FALSE. Il flag enable_unicode specifica se il debugger visualizza puntatori e matrici USHORT come stringhe Unicode.

force_radix_output: flag

TRUE o FALSE. Il flag force_radix_output specifica se i numeri interi vengono visualizzati in formato decimale o nel formato radix predefinito.

col_mode: flag

TRUE o FALSE. Il flag col_mode controlla l'impostazione della modalità colore. Quando la modalità colore è abilitata, il debugger può produrre output colorato. Per impostazione predefinita, la maggior parte dei colori non è impostata e per impostazione predefinita i colori correnti della console.

col: nome colspec

Il nome indica l'elemento che si sta colorando. Colspec è un indicatore RGB a tre lettere del formato [rR-][gG-][bB-]. Una lettera minuscola indica una lettera minuscola più scura, una lettera maiuscola indica un carattere più luminoso e un trattino indica che non viene fornito alcun contributo del componente colore. A causa delle limitazioni del colore della console, la luminosità non è effettivamente per componente, ma si applica a tutti i componenti se una richiesta è brillante. In altre parole, rgB è uguale a RGB. Per questo motivo, è consigliabile utilizzare tutti i maiuscole se verranno utilizzati i maiuscole.

Sintassi di esempio:

col: emphfg R--

Di seguito è riportata una sezione [NTSD] di esempio nel file tools.ini:

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