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 suivi sous forme lisible, Tracefmt doit appliquer les instructions de mise en forme d’un fichier de format de message de suivi aux messages de suivi. 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 de suivi des événements (.etl) qui contient les messages de trace. Entrez le chemin d’accès (facultatif) et le nom du fichier. La valeur par défaut est c:\logfile.etl.

-rtSessionName
En temps réel. Met en forme les messages de suivi à partir des sessions de suivi en temps réel spécifiées, plutôt qu’à partir d’un journal de trace.

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

-tmfTMFFile
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 suivi. La valeur par défaut est Default.tmf, un fichier inclus dans le WDK.

-iImageFiles
Indique à Tracefmt de rechercher les fichiers de symbole PDB pour les fichiers image spécifiés et de 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. Utiliser un point-virgule (;) pour séparer les noms de fichiers image.

-rSymbolPaths
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 d’accès de serveur de symboles. Utiliser un point-virgule (;) pour séparer les noms de chemin d’accès. Les noms de chemin 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 que vous omettez -r, Tracepdb recherche les fichiers PDB pour les images spécifiées dans les chemins spécifiés par la variable d’environnement %_NT_SYMBOL_PATH%. Si la variable d’environnement n’est pas définie, Tracepdb recherche dans le chemin de symbole par défaut , srv*\\\\\symbols\\symbols.

-pTMFPath
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 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% si elle est définie. 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.

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

OutputFile est un chemin d’accès et un nom de fichier avec une extension de nom de fichier .txt, par exemple 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 sous la forme d’un fichier de longueur variable (.csv) séparé par des virgules. Ce format ajoute un préfixe structuré et détaillé à 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 colonne 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.

-Affichage
Affiche les messages de suivi dans la fenêtre d’invite de commandes, en plus de les écrire dans le fichier de sortie.

-displayonly
Affiche les messages de suivi 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 message récapitulative.

-summaryonly
Crée uniquement un fichier de message récapitulative. Tracefmt ne crée pas de fichier de sortie.

-noprefix
Omet le préfixe de message de trace. Cette option affecte les messages de suivi 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 de compteur de performances est utilisée pour l’horodatage du message de suivi, 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 Syntaxe de la commande Tracelog.

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

-Ods
Envoie les messages de trace mis en forme 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 suivi 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 suivi 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.

-C
Verbose. Affiche des informations détaillées dans la fenêtre d’invite de commandes, car Tracefmt traite chaque bloc ou mémoire tampon de messages de trace. Utilisez cette option lorsque vous soupçonnez un fichier endommagé ou des incohérences.

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 dans lequel Tracefmt les utilise.

• Paramètre -tmf .

• Paramètre -p .

• Variable d’environnement %TRACE_FORMAT_SEARCH_PATH%.

• Default.tmf, un fichier inclus dans le 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 suivi, 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 pour tous 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 d’accès complet au fichier.

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

Pour mettre en forme des messages à partir de la session de suivi de l’enregistreur d’événements du noyau NT ou d’une session de suivi de l’enregistreur d’événements global, 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 (temps réel), Tracefmt affiche un message confirmant qu’il est en mode temps réel, puis attend les messages de suivi du fournisseur de trace spécifié. Il ne retourne pas à l’invite de commandes tant que la session de suivi ne s’arrête pas.

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 de 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 Syntaxe de la commande Tracelog.

Messages de trace hors séquence

Si vous affichez un fichier de message de trace sur un ordinateur exécutant Windows XP, l’affichage peut afficher des messages de trace qui sont hors séquence. Pour résoudre ce problème, vous pouvez utiliser l’option de numéro de séquence lorsque vous démarrez la session de trace et que vous 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 versions ultérieures de Windows.