Freigeben über


Tracepdb-Befehle

Um Tracepdb zu verwenden, geben Sie die Befehle in ein Eingabeaufforderungsfenster ein. Die folgende Syntax zeigt die Elemente eines Tracepdb-Befehls an.

Verwenden Sie die folgenden Parameter, um den Speicherort der PDB-Dateien anzugeben.

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

Verwenden Sie die folgenden Parameter, um eine Bilddatei für den Ablaufverfolgungsanbieter anzugeben.

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

Parameter

-f PDBfiles
Gibt den Speicherort der PDB-Symboldateien an, die die Eingabe für Tracepdb sind. Der Standardwert ist *.pdb im lokalen Verzeichnis.

PDBFiles sind der Pfad und die Dateinamen einer oder mehrerer PDB-Dateien. Die Dateinamen können Platzhalterzeichen enthalten, z. B. ein Sternchen (*) zur Darstellung mehrerer Zeichen und ein Fragezeichen (?), um ein einzelnes Zeichen darzustellen. Verwenden Sie ein Semikolon (;) zum Trennen von Dateinamen.

-s
Sucht rekursiv. Erstellt TMF-Dateien für alle PDB-Dateien, die dem Wert des Parameters -f im Verzeichnis und allen Unterverzeichnissen des pfads entsprechen, der durch den Parameter -f angegeben wird. Wenn -f ausgelassen wird, erstellt -s TMF-Dateien für alle PDB-Dateien im lokalen Verzeichnis und deren Unterverzeichnisse.

-p TMFDirectory
Gibt einen Speicherort für die TMF-Dateien an, die Tracepdb erstellt. Der Standardwert ist das lokale Verzeichnis.

Die TMF-Datei ist die Tracepdb-Ausgabedatei. Sie können den Namen der TMF-Datei nicht angeben. Der Dateiname ist die Nachrichten-GUID des Ablaufverfolgungsanbieters.

-Ich ImageFiles
Gibt den Speicherort der Bilddateien von Ablaufverfolgungsanbietern auf dem lokalen Computer an. Wenn Sie den Parameter "-i " verwenden, verwendet Tracepdb den Namen und die Version der Bilddatei, um die PDB-Symboldatei zu suchen.

ImageFiles sind die Pfade und Dateinamen einer oder mehrerer Binärdateien (.exe, .dll, .sys) von Ablaufverfolgungsanbietern. Die Dateinamen in ImageFiles können Wildcardzeichen enthalten, z. B. * (um mehrere Zeichen darzustellen) und ? (um ein einzelnes Zeichen darzustellen). Verwenden Sie ein Semikolon (;), um Bilddateinamen zu trennen.

-r SymbolPaths
Gibt den Speicherort der PDB-Symboldateien an.

SymbolPaths stellt einen oder mehrere Pfade zu Verzeichnissen dar, die private Symbole oder Verzeichnisse auf einem Symbolserver speichern. Die Pfadnamen in SymbolPaths können Wildcardzeichen enthalten, z. B. * (um mehrere Zeichen darzustellen) und ? (um ein einzelnes Zeichen darzustellen).

Wenn Sie den Parameter "-i" angeben, aber "-r" weglassen, sucht Tracepdb nach den PDB-Dateien nach den angegebenen Bildern in den pfaden, die durch die Umgebungsvariable %_NT_SYMBOL_PATH% angegeben wurden. Wenn die Umgebungsvariable nicht festgelegt ist, durchsucht Tracepdb den Standardsymbolpfad srv*\\\\symbols\\symbols.if the environment variable is not set, Tracepdb searches in the default symbol path, srv*\\\symbols\.

-v
Zeigt eine ausführliche Ausgabe an.

-c
Generiert TMC-Dateien .

Beispiele

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

Kommentare

Der Name der TMF-Datei ist die Nachrichten-GUID der Quelldatei. Die Nachrichten-GUID stellt eine Quelldatei und die Ablaufverfolgungseinträge in der Datei dar. Windows verwendet die Nachrichten-GUID, um eine Ablaufverfolgungsnachricht mit der TMF-Datei zu verknüpfen, die Formatierungsanweisungen für die Nachricht enthält.

Wenn Sie eine PDB-Symboldatei übermitteln, die keine Anweisungen zur Ablaufverfolgungsformatierung enthält, zeigt Tracepdb eine Informationsmeldung an und erstellt keine Dateien.

Wenn Tracefmt keine PDB-Dateien im angegebenen Pfad finden kann, wird sie ohne Kommentar an die Eingabeaufforderung zurückgegeben. Um Verarbeitungsdetails abzurufen, übermitteln Sie den Befehl erneut mit dem Parameter "-v ".