Commandes Tracepdb

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

Utilisez les paramètres suivants pour spécifier l’emplacement des fichiers PDB.

    tracepdb [-f PDBFiles] [-s] [-p TMFDirectory] [-v] [-c]

Utilisez les paramètres suivants pour spécifier un fichier image pour le fournisseur de trace.

    tracepdb -i ImageFiles [-r SymbolPaths] [-p TMFDiretory]  [-v]

Paramètres

-fPDBfiles
Spécifie l’emplacement des fichiers de symboles PDB qui sont l’entrée dans Tracepdb. La valeur par défaut est *.pdb dans le répertoire local.

Les PDBFiles sont le chemin d’accès et les noms de fichiers d’un ou de plusieurs fichiers PDB. Les noms de fichiers 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. Utiliser un point-virgule (;) pour séparer les noms de fichiers.

-s
Recherche de manière récursive. Crée des fichiers TMF pour tous les fichiers PDB qui correspondent à la valeur du paramètre -f dans le répertoire et tous les sous-répertoires du chemin spécifié par le paramètre -f . Si -f est omis, -s crée des fichiers TMF pour tous les fichiers PDB dans le répertoire local et ses sous-répertoires.

-pTMFDirectory
Spécifie un emplacement pour les fichiers TMF créés par Tracepdb. La valeur par défaut est le répertoire local.

Le fichier TMF est le fichier de sortie Tracepdb. Vous ne pouvez pas spécifier le nom du fichier TMF. Le nom de fichier est le GUID de message du fournisseur de trace.

-iImageFiles
Spécifie l’emplacement des fichiers image des fournisseurs de trace sur l’ordinateur local. Lorsque vous utilisez le paramètre -i , Tracepdb utilise le nom et la version du fichier image pour localiser son fichier de symboles PDB.

Les fichiers ImageFile sont les chemins d’accès et les noms de fichiers d’un ou plusieurs fichiers binaires (.exe, .dll, .sys) des fournisseurs de trace. Les noms de fichiers dans ImageFiles peuvent inclure des caractères génériques, tels que * (pour représenter plusieurs caractères) et ? (pour représenter un caractère unique). Utilisez un point-virgule (;) pour séparer les noms de fichiers image.

-rSymbolPaths
Spécifie l’emplacement des fichiers de symboles PDB.

SymbolPaths représente un ou plusieurs chemins d’accès aux répertoires qui stockent des symboles privés ou des répertoires sur un serveur de symboles. Les noms de chemin dans SymbolPaths peuvent inclure des caractères génériques, tels que * (pour représenter plusieurs caractères) et ? (pour représenter un caractère unique).

Si vous incluez le paramètre -i , mais 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 des symboles par défaut , srv*\\\\symbols\\symbols.

-C
Affiche une sortie détaillée.

-C
Génère des fichiers TMC .

Exemples

tracepdb -v
tracepdb -f tracedrv.pdb
tracepdb -f c:\tracing\ndis*.pdb -s
tracepdb -f d:\tools\trace*.pdb -p d:\tracing
tracepdb -i d:\winddk\7060\src\general\tracing\tracedrv\objfre_wnet_x86_vh\tracedrv.sys -r 
tracepdb -i trace*.exe;flpy*.dll -p d:\tracing
tracepdb -i tracedrv.exe -r srv*\\\\symbolstore\\symbols\\new

Commentaires

Le nom du fichier TMF est le GUID du message du fichier source. Le GUID du message représente un fichier source et les entrées de trace dans le fichier. Windows utilise le GUID de message pour associer un message de trace au fichier TMF qui contient des instructions de mise en forme pour le message.

Si vous envoyez un fichier de symboles PDB qui n’inclut pas d’instructions de mise en forme de trace, Tracepdb affiche un message d’information et ne crée aucun fichier.

Si Tracefmt ne trouve aucun fichier PDB dans le chemin spécifié, il retourne à l’invite de commandes sans commentaire. Pour obtenir les détails du traitement, renvoyez la commande avec le paramètre -v .