Tracepdb Commands

To use Tracepdb, type the commands in a Command Prompt window. The following syntax displays the elements of a Tracepdb command.

Use the following parameters to specify the location of the PDB files.

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

Use the following parameters to specify an image file for the trace provider.

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

Parameters

-f PDBfiles
Specifies the location of the PDB symbol files that are the input to Tracepdb. The default is *.pdb in the local directory.

PDBFiles are the path and file names of one or more PDB files. The file names can include wildcard characters, such as an asterisk (*) to represent multiple characters and a question mark (?) to represent a single character. Use a semicolon (;) to separate file names.

-s
Searches recursively. Creates TMF files for all PDB files that match the value of the -f parameter in the directory and all subdirectories of the path specified by the -f parameter. If -f is omitted, -s creates TMF files for all PDB files in the local directory and its subdirectories.

-p TMFDirectory
Specifies a location for the TMF files that Tracepdb creates. The default is the local directory.

The TMF file is the Tracepdb output file. You cannot specify the name of the TMF file. The file name is the message GUID of the trace provider.

-i ImageFiles
Specifies the location of the image files of trace providers on the local computer. When you use the -i parameter, Tracepdb uses the name and version of the image file to locate its PDB symbol file.

ImageFiles are the paths and file names of one or more binary files (.exe, .dll, .sys) of trace providers. The file names in ImageFiles can include wildcard characters, such as * (to represent multiple characters) and ? (to represent a single character). Use a semicolon (;) to separate image file names.

-r SymbolPaths
Specifies the location of the PDB symbol files.

SymbolPaths represents one or more paths to directories that store private symbols or to directories on a symbol server. The path names in SymbolPaths can include wildcard characters, such as * (to represent multiple characters) and ? (to represent a single character).

If you include the -i parameter, but omit -r, Tracepdb searches for the PDB files for the specified images in the paths specified by the %_NT_SYMBOL_PATH% environment variable. If the environment variable is not set, Tracepdb searches in the default symbol path, srv*\\\\symbols\\symbols.

-v
Displays verbose output.

-c
Generates TMC files.

Examples

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

Comments

The name of the TMF file is the message GUID of the source file. The message GUID represents a source file and the trace entries in the file. Windows uses the message GUID to associate a trace message with the TMF file that contains formatting instructions for the message.

If you submit a PDB symbol file that does not include trace formatting instructions, Tracepdb displays an information message and does not create any files.

If Tracefmt cannot find any PDB files in the path specified, it returns to the command prompt without comment. To get processing details, resubmit the command with the -v parameter.