Comandi Tracefmt
Per usare Tracefmt, digitare i comandi in una finestra del prompt dei comandi. Nella sintassi seguente vengono visualizzati gli elementi di un comando Tracefmt.
Per visualizzare i messaggi di traccia in formato leggibile, Tracefmt deve applicare le istruzioni di formattazione in un file di formato messaggio di traccia ai messaggi di traccia. La sintassi usata dipende dal fatto che sia presente un file TMF per il provider di traccia o se si vuole che Tracefmt crei un file TMF.
Per fornire un file TMF o un percorso a una directory di file TMF:
tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]
Per creare un file TMF:
tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]
Per visualizzare la sintassi nella riga di comando.
tracefmt -h | /?
Parametri
EtlFile
Specifica il file del log di traccia eventi (con estensione etl) che contiene i messaggi di traccia. Immettere il percorso (facoltativo) e il nome del file. Il valore predefinito è c:\logfile.etl.
-Rt SessionName
Tempo reale. Formatta i messaggi di traccia dalle sessioni di traccia in tempo reale specificate, anziché da un log di traccia.
SessionName è il nome della sessione di traccia. Il valore predefinito è NT Kernel Logger.
-tmf TMFFile
Specifica il percorso (facoltativo) e il nome file di un file di formato di messaggio di traccia (con estensione tmf) per i messaggi di traccia. Il valore predefinito è Default.tmf, un file incluso in WDK.
-io ImageFiles
Indirizza Tracefmt a trovare i file di simboli PDB per i file di immagine specificati e a creare un file TMF dalle istruzioni di formattazione nei file PDB.
ImageFiles rappresenta il percorso e i nomi di file di uno o più file binari (.exe, .dll o .sys) per i provider di traccia. Usare un punto e virgola (;) per separare i nomi dei file di immagine.
-r SymbolPaths
Specifica il percorso dei file di simboli PDB privati per i file di immagine specificati in -i.
SymbolPaths rappresenta uno o più percorsi delle directory in cui sono archiviati simboli privati o percorsi del server di simboli. Usare un punto e virgola (;) per separare i nomi dei percorsi. I nomi di percorso in SymbolPaths possono includere caratteri jolly, ad esempio un asterisco (*) per rappresentare più caratteri e un punto interrogativo (?) per rappresentare un singolo carattere.
Se si include -i in un comando, ma si omette -r, Tracepdb cerca i file PDB per le immagini specificate nei percorsi specificati dalla variabile di ambiente %_NT_SYMBOL_PATH%. Se la variabile di ambiente non è impostata, Tracepdb cerca nel percorso del simbolo predefinito srv *\\\\symbols\\symbols.
-p TMFPath
Specifica il percorso della directory in cui sono archiviati i file TMF.
Quando -p viene usato senza -i, Tracefmt cerca nel percorso specificato da -p per un file TMF esistente. Se -p viene omesso Tracefmt cerca il file TMF nel valore della variabile di ambiente %TRACE_FORMAT_SEARCH_PATH%, se impostato. In caso contrario, Tracefmt tenta di applicare le istruzioni di formattazione nel file Default.tmf.
Quando -p viene usato con -i, Tracefmt inserisce il file TMF creato nella directory specificata da -p. Se -p viene omesso, Tracefmt inserisce il file TMF nella directory specificata dal valore della variabile di ambiente %TRACE_FORMAT_SEARCH_PATH%, se impostato. In caso contrario, Tracefmt inserisce il file nella directory locale.
-h | /?
Visualizza la Guida.
-o OutputFile
Specifica nomi alternativi per il file di output Tracefmt e il file di messaggio di riepilogo Tracefmt. I valori predefiniti sono FmfFile.txt (per il file di output) e FmtSum.txt.sum (per il file di riepilogo) nella directory locale.
OutputFile è un percorso e un nome di file con un'estensione di file .txt, ad esempio c:\traces\trace.txt.
Se si usa questo parametro con le opzioni -displayonly o -summaryonly , influisce solo sul file di messaggio di riepilogo.
-csv
Formatta il file di output Tracefmt come file di lunghezza variabile (.csv) delimitato da virgole. Questo formato aggiunge un prefisso dettagliato e strutturato a ogni messaggio, oltre al prefisso del messaggio di traccia standard.
Questa opzione influisce sul file di output e sulla visualizzazione dei messaggi di traccia nella finestra del prompt dei comandi, se presente.
-csvheader
Aggiunge una riga di intestazioni di colonna descrittive al file CSV. Questa intestazione è particolarmente utile per interpretare il prefisso strutturato aggiunto da Tracefmt ai file CSV. Per impostazione predefinita, i file CSV Tracefmt non hanno intestazioni di colonna.
-csvquote
Raddoppia tutte le virgolette (") nel file CSV. Questa funzionalità è progettata per le applicazioni che visualizzano virgolette solo quando sono racchiuse tra virgolette.
-esporre
Visualizza i messaggi di traccia nella finestra del prompt dei comandi, oltre a scriverli nel file di output.
-displayonly
Visualizza i messaggi di traccia solo nella finestra del prompt dei comandi e non crea un file di output.
-nosummary
Non crea un file di messaggio di riepilogo.
-summaryonly
Crea solo un file di messaggio di riepilogo. Tracefmt non crea un file di output.
-noprefix
Omette il prefisso del messaggio di traccia. Questa opzione influisce sui messaggi di traccia nel file di output e sulla visualizzazione Tracefmt.
-Assume
Alta risoluzione. Visualizza il numero di microsecondi e nanosecondi nel timestamp del messaggio di traccia. Per impostazione predefinita, vengono visualizzati solo i millisecondi.
Utilizzare questa opzione quando viene usato un valore dell'orologio del contatore delle prestazioni per il timestamp del messaggio di traccia, anziché il timer di sistema, ad esempio quando viene usato il parametro Tracelog -UsePerfCounter . Per informazioni sui comandi tracelog, vedere Sintassi dei comandi tracelog.
-Seq
Visualizza i numeri di sequenza locali o globali nel prefisso del messaggio di traccia. Se i numeri di sequenza non sono stati registrati nel messaggio, il campo non è inizializzato o riempito con zeri o "f".
-Ods
Invia i messaggi di traccia formattati al debugger per la visualizzazione.
-Gmt
Visualizza il timestamp in ogni messaggio di traccia in Greenwich Mean Time (GMT).
Questa opzione influisce solo sul file di output Tracefmt. Non converte i timestamp nel file del log di traccia eventi (con estensione etl). Il fuso orario del log di traccia viene visualizzato quando si invia un comando Tracefmt.
-Utc
Visualizza il timestamp in ogni messaggio di traccia in utc (Coordinated Universal Time). UTC è quasi identico a GMT, ma rappresenta la mezzanotte come zero.
Questa opzione influisce solo sul file di output Tracefmt. Non converte i timestamp nel file del log di traccia eventi (con estensione etl). Il fuso orario del file di log di traccia viene visualizzato quando si invia un comando Tracefmt.
-traccia
Visualizza le azioni Tracefmt man mano che si verificano. Queste informazioni sono utili quando la formattazione non è corretta o quando Tracefmt segnala un errore o un'eccezione.
La visualizzazione della traccia può essere estesa. È consigliabile reindirizzare l'output Tracefmt a un file di testo per un esame successivo.
-v
Verbose. Visualizza informazioni dettagliate nella finestra del prompt dei comandi mentre Tracefmt elabora ogni blocco o buffer di messaggi di traccia. Usare questa opzione quando si sospettano danni al file o incoerenze.
Commenti
Ricerca del file TMF
Se si omette il parametro -i , Tracefmt usa i metodi seguenti per trovare il file TMF. I metodi sono elencati nell'ordine in cui Tracefmt li usa.
Parametro -tmf .
Parametro -p .
Variabile di ambiente %TRACE_FORMAT_SEARCH_PATH%.
Default.tmf, un file incluso in WDK.
Se Tracefmt non riesce a trovare un file TMF o il file TMF non include informazioni di formattazione per i messaggi di traccia, Tracefmt non può visualizzare i messaggi. Scrive invece il messaggio di errore seguente al posto del messaggio di traccia
No Format Information found.
Eccezione generata
Se Tracefmt non è in grado di formattare un parametro del messaggio di traccia, genera un'eccezione e visualizza un messaggio come:
*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****
Se viene visualizzata un'eccezione simile, esaminare la definizione del messaggio nel codice sorgente, con particolare attenzione a qualsiasi tipo di variabile specificato dall'utente. Per altre informazioni, vedere DoTraceMessage.
File TMF con nomi di file non GUID
Se il nome del file TMF non è un GUID del messaggio, è necessario usare il parametro -tmf per identificare il file e immettere il percorso completo del file.
Formattazione dei messaggi di traccia del logger del kernel NT
Per formattare i messaggi dalla sessione di traccia NT Kernel Logger o da una sessione di traccia globale del Logger, usare il parametro -tmf per specificare il file system.tmf, un file di formato del messaggio di traccia incluso in WDK..
Formattazione dei messaggi di traccia da sessioni di traccia in tempo reale
Quando si usa il parametro -rt (in tempo reale), Tracefmt visualizza un messaggio che conferma che è in modalità in tempo reale e quindi attende i messaggi di traccia dal provider di traccia specificato. Non torna al prompt dei comandi fino all'arresto della sessione di traccia.
Formattazione dei timestamp QPC
Tracefmt non formatta correttamente i valori dell'orologio del contatore delle prestazioni di sistema (QueryPerformanceCounter). Se usi questo tempo ad alta risoluzione, usa Tracerpt, uno strumento incluso in Windows, per formattare i messaggi di traccia. Per altre informazioni, vedere la descrizione del parametro -UsePerfCounter nella sintassi dei comandi tracelog.
Messaggi di traccia out-of-sequence
Se si visualizza un file di messaggio di traccia in un computer che esegue Windows XP, la visualizzazione potrebbe mostrare messaggi di traccia non in sequenza. Per risolvere il problema, è possibile usare l'opzione numero di sequenza quando si avvia la sessione di traccia e si visualizza la traccia usando Tracefmt. È quindi possibile visualizzare la traccia con Traceview e ordinare in base al numero di sequenza. È anche possibile visualizzare la traccia in un computer che esegue Windows Server 2003 o versioni successive di Windows.