Condividi tramite


Uso dei comandi del debugger

In questo modo viene descritto l'uso dei comandi del debugger. WinDbg è un debugger che può essere usato per analizzare i dump di arresto anomalo del sistema, eseguire il debug di codice in modalità utente live e in modalità kernel ed esaminare i registri e la memoria della CPU. Per altre informazioni, vedere Panoramica di WinDbg.

Per installare il debugger, vedere Installare il debugger di Windows.

Per iniziare a usare WinDbg, vedere Introduzione con debug di Windows.

Finestra di comando del debugger WinDbg

Per WinDbg, "Finestra comando debugger" fa riferimento alla finestra con etichetta "Comando" nella barra del titolo. Questa finestra contiene due riquadri:

  • Nel riquadro inferiore piccolo immettere i comandi.

  • Nel riquadro superiore di grandi dimensioni è possibile visualizzare l'output dei comandi.

Questa finestra è sempre aperta all'inizio di una sessione di debug. È possibile riaprire o passare a questa finestra selezionando Comando dal menu Visualizza, premendo ALT+1 oppure selezionando il pulsante Comando (ALT+1) (Screenshot della finestra di comando del debugger).

È possibile usare i tasti FRECCIA SU e FRECCIA GIÙ per scorrere la cronologia dei comandi. Quando viene visualizzato un comando precedente, è possibile modificarlo e quindi premere INVIO per eseguire il comando precedente (o la versione modificata del comando precedente). Il cursore non deve trovarsi alla fine della riga per il corretto funzionamento di questa procedura.

KD o CDB

Per KD o CDB, la finestra "Debugger Command window" fa riferimento all'intera finestra. Immettere i comandi al prompt nella parte inferiore della finestra. Se i comandi hanno un output, la finestra visualizza l'output e quindi visualizza di nuovo il prompt.

Prompt delle finestre dei comandi del debugger

Quando si esegue il debug in modalità utente, il prompt nella finestra Comando debugger è simile all'esempio seguente.

2:005>

Nell'esempio precedente, 2 è il numero di processo corrente e 005 è il numero di thread corrente.

Se si collega il debugger a più computer, il numero di sistema viene incluso prima del numero di processo e del thread, come nell'esempio seguente.

3:2:005>

In questo esempio, 3 è il numero di sistema corrente, 2 è il numero di processo corrente e 005 è il numero di thread corrente.

Quando si esegue il debug in modalità kernel in un computer di destinazione con un solo processore, il prompt sarà simile all'esempio seguente.

kd>

Tuttavia, se il computer di destinazione dispone di più processori, il numero del processore corrente viene visualizzato prima della richiesta, come nell'esempio seguente.

0: kd>

Se il debugger è occupato nell'elaborazione di un comando emesso in precedenza, i nuovi comandi non verranno elaborati temporaneamente, anche se possono essere aggiunti al buffer dei comandi. Inoltre, puoi comunque usare i tasti di controllo in KD e CDB e puoi comunque usare i comandi di menu e i tasti di scelta rapida in WinDbg. Quando KD o CDB si trova in questo stato occupato, non viene visualizzata alcuna richiesta. Quando WinDbg è in questo stato occupato, al posto del prompt verrà visualizzato l'indicatore seguente:

*BUSY*

È possibile usare il comando .pcmd (Set Prompt Command) per aggiungere testo a questo prompt.

Tipi di comandi

WinDbg, KD e CDB supportano un'ampia gamma di comandi. Alcuni comandi vengono condivisi tra i debugger e alcuni sono disponibili solo in uno o due dei debugger.

Alcuni comandi sono disponibili solo nel debug in tempo reale e altri comandi sono disponibili solo quando si esegue il debug di un file di dump.

Alcuni comandi sono disponibili solo durante il debug in modalità utente e altri comandi sono disponibili solo durante il debug in modalità kernel.

Alcuni comandi sono disponibili solo quando la destinazione è in esecuzione in determinati processori. Per altre informazioni su tutti i comandi e le relative restrizioni, vedere Comandi del debugger.

Modifica, ripetizione e annullamento dei comandi

È possibile usare le chiavi di modifica standard quando si immette un comando:

  • Usare i tasti FRECCIA SU e FRECCIA GIÙ per trovare i comandi precedenti.

  • Modificare il comando corrente con i tasti BACKSPACE, DELETE, INSERT e FRECCIA SINISTRA e FRECCIA DESTRA.

  • Premere ESC per cancellare la riga corrente.

È possibile premere TAB per completare automaticamente la voce di testo. In uno dei debugger premere TAB dopo aver immesso almeno un carattere per completare automaticamente un comando. Premere ripetutamente TAB per scorrere le opzioni di completamento del testo e tenere premuto MAIUSC e premere TAB per scorrere indietro. È anche possibile usare caratteri jolly nel testo e premere TAB per espandere il set completo di opzioni di completamento del testo. Ad esempio, se si digita fo*!ba e quindi si preme TAB, il debugger si espande al set di tutti i simboli che iniziano con "ba", in tutti i moduli con nomi di modulo che iniziano con "fo". Come altro esempio, è possibile completare tutti i comandi di estensione che contengono "prcb" digitando !*prcb e quindi premendo TAB.

Quando si usa il tasto TAB per eseguire il completamento del testo, se il frammento di testo inizia con un punto (.), il testo viene associato a un comando punto. Se il frammento di testo inizia con un punto esclamativo (!), il testo viene confrontato con un comando di estensione. In caso contrario, il testo viene confrontato con un simbolo. Quando si usa il tasto TAB per immettere i simboli, premendo TAB viene completato il codice e i simboli di tipo e i nomi dei moduli. Se non è evidente alcun nome di modulo, i simboli locali e i nomi dei moduli vengono completati. Se viene specificato un modulo o un modello di modulo, il completamento del simbolo completa il codice e i simboli di tipo da tutte le corrispondenze.

È possibile selezionare e tenere premuto (o fare clic con il pulsante destro del mouse) nella finestra Comando debugger per incollare automaticamente il contenuto degli Appunti nel comando digitato.

La lunghezza massima del comando è di 4096 caratteri. Tuttavia, se si controlla il debugger in modalità utente dal debugger del kernel, la lunghezza massima della riga è di 512 caratteri.

In CDB e KD premere INVIO per ripetere il comando precedente. In WinDbg è possibile abilitare o disabilitare questo comportamento. Per altre informazioni su questo comportamento, vedere INVIO (Ripeti ultimo comando) .

Se l'ultimo comando emesso presenta una visualizzazione lunga e si vuole tagliarla, usare il tasto CTRL+C in CDB o KD. In WinDbg usare Debug | Interrompere o premere CTRL+INTERR.

Nel debug in modalità kernel è possibile annullare i comandi dalla tastiera del computer di destinazione premendo CTRL+C.

È possibile usare il comando .cls (Clear Screen) per cancellare tutto il testo dalla finestra Di comando del debugger. Questo comando cancella l'intera cronologia dei comandi. In WinDbg è possibile cancellare la cronologia dei comandi usando Modifica | Deselezionare il comando Output comando o selezionando Cancella output comando dal menu di scelta rapida della finestra Comando debugger.

Sintassi delle espressioni

Molti comandi e comandi di estensione accettano espressioni come argomenti. Il debugger valuta queste espressioni prima di eseguire il comando. Per altre informazioni sulle espressioni, vedere Valutazione di espressioni.

Alias

Gli alias sono macro di testo che è possibile usare per evitare di dover digitare frasi complesse. Esistono due tipi di alias. Per altre informazioni sugli alias, vedere Uso di alias.

comandi Self-Repeating

È possibile usare i comandi seguenti per ripetere un'azione o eseguire in modo condizionale altri comandi:

Per altre informazioni su ogni comando, vedere i singoli argomenti relativi ai comandi.

Controllo dello scorrimento

È possibile usare la barra di scorrimento per visualizzare i comandi precedenti e il relativo output.

Quando si usa CDB o KD, qualsiasi voce della tastiera scorre automaticamente verso il basso fino alla fine della finestra Di comando del debugger.

In WinDbg la visualizzazione scorre automaticamente verso il basso ogni volta che un comando produce output o si preme INVIO. Se si desidera disabilitare questo scorrimento automatico, selezionare le opzioni nel menu Visualizza e quindi deselezionare la casella di controllo Scorrimento automatico .

Funzionalità di testo WinDbg

In WinDbg è possibile usare diverse funzionalità aggiuntive per modificare la modalità di visualizzazione del testo nella finestra Comando debugger. È possibile accedere ad alcune di queste funzionalità nella finestra WinDbg, alcuni nel menu di scelta rapida nella finestra Comando debugger e alcuni selezionando l'icona di menu appropriata.

  • Il comando di ritorno a capo Word nel menu di scelta rapida attiva e disattiva lo stato di ritorno a capo automatico. Questo comando influisce sull'intera finestra, non solo sui comandi usati dopo la modifica di questo stato. Poiché molti comandi ed estensioni producono visualizzazioni formattate, in genere non è consigliabile eseguire il ritorno a capo automatico.

  • Modifica | Il comando di menu Aggiungi all'output dei comandi aggiunge un commento nella finestra Comando debugger. Il comando Aggiungi all'output del comando nel menu di scelta rapida ha lo stesso effetto.

  • È possibile personalizzare i colori usati per il testo e lo sfondo della finestra Comando debugger. È possibile specificare colori diversi per diversi tipi di testo. Ad esempio, è possibile visualizzare l'output del registro automatico in un colore, i messaggi di errore in un altro colore e i messaggi DbgPrint in un terzo colore.

  • È possibile usare tutte le funzionalità comuni alle finestre di debug di WinDbg, ad esempio personalizzare i tipi di carattere e usare comandi di modifica speciali.

Remote Debugging

Quando si esegue il debug remoto tramite il debugger, il client di debug può accedere a un numero limitato di comandi. Per modificare il numero di comandi a cui è possibile accedere il client, usare l'opzione della riga di comando -clines o la variabile di ambiente _NT_DEBUG_HISTORY_SIZE.