Commandes Tracefmt

Pour utiliser Tracefmt, tapez les commandes dans une fenêtre d’invite de commandes. La syntaxe suivante affiche les éléments d’une commande Tracefmt.

Pour afficher les messages de trace sous forme lisible, Tracefmt doit appliquer les instructions de mise en forme dans un fichier de format de message de trace aux messages de trace. La syntaxe que vous utilisez varie selon que vous disposez d’un fichier TMF pour le fournisseur de trace ou si vous souhaitez que Tracefmt crée un fichier TMF.

Pour fournir un fichier TMF ou un chemin d’accès à un répertoire de fichiers TMF :

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

Pour créer un fichier TMF :

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

Pour afficher la syntaxe sur la ligne de commande.

    tracefmt -h | /?

Paramètres

EtlFile
Spécifie le fichier journal des traces des événements (.etl) qui contient les messages de trace. Entrez le chemin (optionnel) et le nom du fichier. La valeur par défaut est c:\logfile.etl.

-Rt Nom_session
Temps réel. Met en forme les messages de suivi à partir des sessions de trace en temps réel spécifiées, au lieu d’un journal de trace.

SessionName est le nom de la session de trace. La valeur par défaut est NT Kernel Logger.

-tmf TMFFile
Spécifie le chemin d’accès (facultatif) et le nom de fichier d’un fichier de format de message de trace (.tmf) pour les messages de trace. La valeur par défaut est Default.tmf, un fichier inclus dans le WDK.

-Je ImageFiles
Dirige Tracefmt pour rechercher les fichiers de symboles PDB pour les fichiers image spécifiés et créer un fichier TMF à partir des instructions de mise en forme dans les fichiers PDB.

ImageFiles représente le chemin d’accès et les noms de fichiers d’un ou plusieurs fichiers binaires (.exe, .dll ou .sys) pour les fournisseurs de trace. Utilisez un point-virgule (;) pour séparer les noms de fichiers image.

-r SymbolPaths
Spécifie l’emplacement des fichiers de symboles PDB privés pour les fichiers image spécifiés dans -i.

SymbolPaths représente un ou plusieurs chemins d’accès aux répertoires qui stockent des symboles privés ou des chemins de serveur de symboles. Utilisez un point-virgule (;) pour séparer les noms de chemins d’accès. Les noms de chemin d’accès dans SymbolPaths peuvent inclure des caractères génériques, tels qu’un astérisque (*) pour représenter plusieurs caractères et un point d’interrogation ( ?) pour représenter un seul caractère.

Si vous incluez -i dans une commande, mais omettez -r, Tracepdb recherche les fichiers PDB pour les images spécifiées dans les chemins d’accès spécifiés par la variable d’environnement %_NT_SYMBOL_PATH%. Si la variable d’environnement n’est pas définie, Tracepdb effectue des recherches dans le chemin d’accès de symbole par défaut, srv*\\\symbols\\symbols.

-p TMFPath
Spécifie le chemin d’accès au répertoire qui stocke les fichiers TMF.

Lorsque -p est utilisé sans -i, Tracefmt recherche dans le chemin spécifié par -p pour un fichier TMF existant. Si -p est omis Tracefmt recherche le fichier TMF dans la valeur de la variable d’environnement %TRACE_FORMAT_SEARCH_PATH%, s’il est défini. Sinon, Tracefmt tente d’appliquer les instructions de mise en forme dans le fichier Default.tmf.

Lorsque -p est utilisé avec -i, Tracefmt place le fichier TMF qu’il crée dans le répertoire spécifié par -p. Si -p est omis, Tracefmt place le fichier TMF dans le répertoire spécifié par la valeur de la variable d’environnement %TRACE_FORMAT_SEARCH_PATH% si elle est définie. Sinon, Tracefmt place le fichier dans le répertoire local.

-h | /?
Affiche de l’aide.

-o OutputFile
Spécifie d’autres noms pour le fichier de sortie Tracefmt et le fichier de message de synthèse Tracefmt. Les valeurs par défaut sont FmfFile.txt (pour le fichier de sortie) et FmtSum.txt.sum (pour le fichier résumé) dans le répertoire local.

OutputFile est un chemin et un nom de fichier avec une extension de nom de fichier .txt, comme c:\traces\trace.txt.

Si vous utilisez ce paramètre avec les options -displayonly ou -summaryonly , il affecte uniquement le fichier de message récapitulative.

-csv
Met en forme le fichier de sortie Tracefmt en tant que fichier de longueur variable séparée par des virgules (.csv). Ce format ajoute un préfixe détaillé et structuré à chaque message, en plus du préfixe de message de trace standard.

Cette option affecte le fichier de sortie et l’affichage des messages de trace dans la fenêtre d’invite de commandes, le cas échéant.

-csvheader
Ajoute une ligne d’en-têtes de colonnes descriptifs au fichier CSV. Cet en-tête est particulièrement utile pour interpréter le préfixe structuré que Tracefmt ajoute aux fichiers CSV. Par défaut, les fichiers CSV Tracefmt n’ont pas d’en-têtes de colonne.

-csvquote
Double tous les guillemets (") dans le fichier CSV. Cette fonctionnalité est conçue pour les applications qui affichent des guillemets uniquement lorsqu’elles sont placées entre guillemets.

-montrer
Affiche les messages de trace dans la fenêtre d’invite de commande, en plus de les écrire dans le fichier de sortie.

-displayonly
Affiche les messages de trace uniquement dans la fenêtre d’invite de commandes et ne crée pas de fichier de sortie.

-nosummary
Ne crée pas de fichier de résumé des messages.

-summaryonly
Crée uniquement un fichier de résumé des messages. Tracefmt ne crée pas de fichier de sortie.

-noprefix
Omet le préfixe des messages de trace. Cette option affecte les messages de trace dans le fichier de sortie et l’affichage Tracefmt.

-Embauche
Haute résolution. Affiche le nombre de microsecondes et de nanosecondes dans l’horodatage du message de trace. Par défaut, seules les millisecondes sont affichées.

Utilisez cette option lorsqu’une valeur d’horloge du compteur de performances est utilisée pour l’horodatage du message de trace, au lieu du minuteur système, par exemple lorsque le paramètre Tracelog -UsePerfCounter est utilisé. Pour plus d’informations sur les commandes Tracelog, consultez la syntaxe des commandes Tracelog.

-Suiv
Affiche les numéros de séquence locaux ou globaux dans le préfixe du message de trace. Si les numéros de séquence n’ont pas été enregistrés dans le message, le champ n’est pas initialisé ou rempli de zéros ou de « f » s.

-Ods
Envoie les messages de trace formatés au débogueur pour affichage.

-Gmt
Affiche l’horodatage sur chaque message de trace dans l’heure moyenne de Greenwich (GMT).

Cette option affecte uniquement le fichier de sortie Tracefmt. Il ne convertit pas les horodatages dans le fichier journal de suivi des événements (.etl). Le fuseau horaire du journal de trace s’affiche lorsque vous envoyez une commande Tracefmt.

-Utc
Affiche l’horodatage sur chaque message de trace en temps universel coordonné (UTC). UTC est presque identique à GMT, mais il représente minuit comme zéro.

Cette option affecte uniquement le fichier de sortie Tracefmt. Il ne convertit pas les horodatages dans le fichier journal de suivi des événements (.etl). Le fuseau horaire du fichier journal de trace s’affiche lorsque vous envoyez une commande Tracefmt.

-trace
Affiche les actions Tracefmt à mesure qu’elles se produisent. Ces informations sont utiles lorsque la mise en forme est incorrecte ou lorsque Tracefmt signale une erreur ou une exception.

L’affichage des traces peut être étendu. Envisagez de rediriger la sortie Tracefmt vers un fichier texte pour un examen ultérieur.

-v
Détaillé. Affiche des informations détaillées dans la fenêtre d’invite de commande pendant que Tracefmt traite chaque bloc ou tampon de messages de trace. Utilisez cette option lorsque vous soupçonnez des dommages ou incohérences de fichier.

Commentaires

Recherche du fichier TMF

Si vous omettez le paramètre -i , Tracefmt utilise les méthodes suivantes pour rechercher le fichier TMF. Les méthodes sont répertoriées dans l’ordre où Tracefmt les utilise.

• Le paramètre -tmf.

• Le paramètre -p.

• La variable d’environnement %TRACE_FORMAT_SEARCH_PATH%.

• Default.tmf, un fichier inclus dans wdK.

Si Tracefmt ne trouve pas de fichier TMF ou si le fichier TMF n’inclut pas d’informations de mise en forme pour les messages de trace, Tracefmt ne peut pas afficher les messages. Au lieu de cela, il écrit le message d’erreur suivant à la place du message de trace

No Format Information found.

Exception levée

Si Tracefmt ne peut pas mettre en forme un paramètre de message de trace, il déclenche une exception et affiche un message tel que :

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

Si vous voyez une exception similaire, passez en revue la définition du message dans le code source, avec une attention particulière sur les types de variables spécifiés par l’utilisateur. Pour plus d’informations, consultez DoTraceMessage.

Fichiers TMF avec des noms de fichiers non GUID

Si le nom de fichier TMF n’est pas un GUID de message, vous devez utiliser le paramètre -tmf pour identifier le fichier et entrer le chemin complet du fichier.

Mise en forme des messages de trace de l’enregistreur d’événements du noyau NT

Pour mettre en forme les messages à partir de la session de trace de l’enregistreur d’événements du noyau NT ou d’une session de trace Global Logger, utilisez le paramètre -tmf pour spécifier le fichier system.tmf, un fichier de format de message de trace inclus dans wdK..

Mise en forme des messages de trace à partir de sessions de suivi en temps réel

Lorsque vous utilisez le paramètre -rt (en temps réel), Tracefmt affiche un message confirmant qu’il est en mode temps réel, puis attend les messages de trace du fournisseur de trace spécifié. Elle ne revient pas à l’invite de commandes tant que la session de trace n’est pas arrêtée.

Mise en forme des horodatages QPC

Tracefmt ne met pas correctement en forme les valeurs de l’horloge du compteur de performances système (QueryPerformanceCounter). Si vous utilisez ce temps à haute résolution, utilisez Tracerpt, un outil inclus dans Windows, pour mettre en forme les messages de trace. Pour plus d’informations, consultez la description du paramètre -UsePerfCounter dans la syntaxe de commande Tracelog.

Messages de suivi hors séquence

Si vous affichez un fichier de message de trace sur un ordinateur exécutant Windows XP, l’affichage peut afficher les messages de suivi hors séquence. Pour corriger ce problème, vous pouvez utiliser l’option numéro de séquence lorsque vous démarrez la session de trace et affichez la trace à l’aide de Tracefmt. Vous pouvez ensuite afficher la trace avec Traceview et trier en fonction du numéro de séquence. Vous pouvez également afficher la trace sur un ordinateur exécutant Windows Server 2003 ou version ultérieure de Windows.