Uso del linguaggio di markup del debugger
I comandi del debugger possono fornire output in testo normale o in un formato avanzato che usa il linguaggio DML (Debugger Markup Language). L'output migliorato con DML include collegamenti su cui è possibile fare clic per eseguire comandi correlati.
DML è disponibile in Windows 10 e versioni successive.
Comandi con supporto DML
I comandi seguenti sono in grado di generare l'output DML:
Il comando lmD è un esempio di comando in grado di fornire l'output DML. Il comando lmD visualizza un elenco di moduli caricati. Come illustrato nell'immagine seguente, ogni nome di modulo è un collegamento su cui è possibile fare clic per ottenere informazioni più dettagliate sul modulo.
L'immagine seguente mostra il risultato del clic sul collegamento usbuhci . L'output include collegamenti aggiuntivi che consentono di esplorare altri dettagli del modulo usbuhci.
Attivazione e disattivazione di DML
Il comando .prefer_dml attiva o disattiva DML. Quando DML è attivato (.prefer_dml 1), i comandi in grado di generare l'output DML genereranno l'output DML per impostazione predefinita.
Miglioramenti della console
Tutti i debugger Windows ora dispongono di aree di output dei comandi che supportano l'analisi DML. In windbg la finestra di comando supporta tutto il comportamento DML e mostrerà colori, stili di carattere e collegamenti. I debugger della console, ntsd, cdb e kd supportano solo gli attributi di colore di DML e solo quando vengono eseguiti in una vera console con la modalità colore abilitata. I debugger con I/O reindirizzato, ntsd –d o remote.exe sessioni non visualizzeranno colori.
Modalità colore debugger console
I debugger della console, ntsd, cdb e kd ora hanno la possibilità di visualizzare l'output colorato durante l'esecuzione in una vera console. Non è l'impostazione predefinita, richiede che la modalità colore sia abilitata in modo esplicito tramite tools.ini. Il nuovo col_mode <token true|false> in tools.ini controlla l'impostazione della modalità colore. Per altre informazioni sull'uso del file di tools.ini, vedere Configurazione di tools.ini
Quando la modalità colore è abilitata, il debugger può produrre output colorato. Per impostazione predefinita, la maggior parte dei colori non è impostata e viene invece impostata per impostazione predefinita sui colori della console correnti.
Finestra del browser dei comandi Windbg
In Windows 10 e versioni successive Windbg la finestra del browser dei comandi analizza e visualizza DML. Tutti i tag, ad <esempio link>, <exec> e modifiche dell'aspetto, sono completamente supportati.
Per avviare una sessione del browser dei comandi usando il menu in WinDbg, selezionare Visualizza, Visualizzatore comandi. Il comando> .browse <nella finestra di comando aprirà una nuova finestra del browser dei comandi ed eseguirà il comando specificato. Per altre informazioni, vedere Uso della finestra del browser dei comandi in WinDbg (versione classica). È anche possibile aprire una nuova finestra del browser dei comandi con CTRL+N.
La finestra del browser dei comandi simula deliberatamente il comportamento di un Web browser, con una cronologia a discesa e pulsanti precedenti/successivi. L'elenco a discesa cronologia visualizza solo gli ultimi venti comandi, ma la cronologia completa viene mantenuta in modo da tornare indietro nei comandi che è possibile ottenere l'elenco a discesa per visualizzare la cronologia precedente.
È possibile aprire tutte le finestre dei comandi contemporaneamente. Le finestre dei comandi vengono mantenute nelle aree di lavoro, ma salvano solo il comando corrente; la storia non viene mantenuta.
Il menu Visualizzazione WinDbg include un'opzione Imposta comando start browser che consente a un utente di impostare un comando preferito per le nuove finestre del browser da avviare, ad esempio .dml_start. Questo comando viene salvato nelle aree di lavoro.
Una sotto-finestra Comandi recenti è disponibile nel menu Visualizza per contenere i comandi di interesse. Se si seleziona un comando recente, viene aperto un nuovo browser con il comando specificato. È presente una voce di menu nel menu di scelta rapida della finestra del browser che aggiunge il comando corrente della finestra all'elenco dei comandi recenti. L'elenco dei comandi recenti viene salvato in modo permanente nelle aree di lavoro.
La finestra del browser dei comandi esegue il comando in modo sincrono e quindi non visualizza l'output fino al completamento del comando. I comandi a esecuzione prolungata non visualizzeranno alcun elemento fino al termine.
I collegamenti hanno un menu di scelta rapida del clic con il pulsante destro del mouse simile al menu di scelta rapida del pulsante destro del mouse in un Web browser. I collegamenti possono essere aperti in una nuova finestra del browser. Il comando di un collegamento può essere copiato negli Appunti per l'uso.
Fare clic sull'icona nell'angolo superiore destro della barra del titolo per impostare le finestre del browser dei comandi su aggiornamento automatico o aggiornamento manuale. I browser di aggiornamento automatico eseguiranno automaticamente il comando sulle modifiche dello stato del debugger. In questo modo l'output viene mantenuto attivo, ma a costo di eseguire il comando in tutte le modifiche. L'aggiornamento automatico è attivato per impostazione predefinita. Se il browser non deve essere attivo, è possibile usare il menu di scelta rapida della finestra per disabilitare l'aggiornamento automatico.
Poiché i comandi vengono eseguiti dal motore, non dall'interfaccia utente, comandi specifici dell'interfaccia utente, ad esempio .cls (Clear Screen) restituiranno un errore di sintassi in quando viene usato nelle finestre del browser dei comandi. Significa anche che quando l'interfaccia utente è un client remoto, il comando verrà eseguito dal server, non dal client e l'output del comando mostrerà lo stato del server.
Le finestre del browser dei comandi possono eseguire qualsiasi comando del debugger, non deve essere un comando che produce DML. È possibile usare le finestre del browser per avere un set arbitrario di comandi attivi per l'uso.
Personalizzazione di DML
DML definisce un piccolo set di tag che possono essere inclusi nell'output dei comandi. Un esempio è il tag di <collegamento> . È possibile sperimentare il tag di <collegamento (e altri tag DML) usando i comandi .dml_start e .browse.> Il comando .browse .dml_start filepath esegue i comandi archiviati in un file DML. L'output viene visualizzato nella finestra Del browser comandi anziché nella normale finestra di comando.
Si supponga che il file c:\DmlExperiment.txt contenga le righe seguenti.
My DML Experiment
<link cmd="lmD musb*">List modules that begin with usb.</link>
Il comando seguente visualizza il testo e il collegamento nella finestra Del browser comandi.
.browse .dml_start c:\Dml_Experiment.txt
Se si fa clic sul collegamento List modules that begin with usb (Elenca moduli che iniziano con usb ), viene visualizzato un output simile all'immagine seguente.
Per una descrizione approfondita della personalizzazione DML e di un elenco completo dei tag DML, vedere Personalizzazione dell'output del debugger tramite DML.