Tracepdb 命令

若要使用 Tracepdb，请在命令提示符窗口中键入命令。 以下语法显示 Tracepdb 命令的元素。

使用以下参数指定 PDB 文件的位置。

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

使用以下参数为跟踪提供程序指定映像文件。

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

参数

-f PDBfiles
指定 PDB 符号文件的位置，这些文件是 Tracepdb 的输入。 默认值为本地目录中的 *.pdb。

PDBFiles 是一个或多个 PDB 文件的路径和文件名。 文件名可以包含通配符，例如星号 • 表示多个字符，以及表示单个字符的问号（？）。 使用分号（;)分隔文件名）。

-s
以递归方式搜索。 为所有 PDB 文件创建 TMF 文件，这些文件与目录中的 -f 参数的值匹配，以及由 -f 参数指定的路径的所有子目录。 如果 省略 -f ， 则 -s 为本地目录及其子目录中的所有 PDB 文件创建 TMF 文件。

-p TMFDirectory
指定 Tracepdb 创建的 TMF 文件的位置。 默认值为本地目录。

TMF 文件是 Tracepdb 输出文件。 不能指定 TMF 文件的名称。 文件名是跟踪提供程序的消息 GUID。

-我 ImageFiles
指定本地计算机上跟踪提供程序的图像文件的位置。 使用 -i 参数时，Tracepdb 使用映像文件的名称和版本来查找其 PDB 符号文件。

ImageFiles 是跟踪提供程序的一个或多个二进制文件（.exe、.dll、.sys）的路径和文件名。 ImageFiles 中的文件名可以包含通配符，例如 * （表示多个字符）和 ？ （表示单个字符）。 使用分号（;）分隔图像文件名。

-r SymbolPaths
指定 PDB 符号文件的位置。

SymbolPath 表示 存储专用符号或符号服务器上的目录的一个或多个路径。 SymbolPaths 中的路径名称可以包含通配符，例如 * （表示多个字符）和 ？ （表示单个字符）。

如果包括 -i 参数，但省略 -r，Tracepdb 会在 %_NT_SYMBOL_PATH% 环境变量指定的路径中搜索指定映像的 PDB 文件。 如果未设置环境变量，Tracepdb 将在默认符号路径 srv*\\symbols\\symbols\\symbols 中搜索。

-v
显示详细输出。

-c
生成 TMC 文件。

示例

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

备注

TMF 文件的名称是 源文件的消息 GUID 。 消息 GUID 表示源文件和文件中的跟踪条目。 Windows 使用消息 GUID 将跟踪消息与包含消息格式说明的 TMF 文件相关联。

如果提交不包含跟踪格式说明的 PDB 符号文件，Tracepdb 将显示信息消息，并且不创建任何文件。

如果 Tracefmt 在指定的路径中找不到任何 PDB 文件，它将返回命令提示符，而不注释。 若要获取处理详细信息，请使用 -v 参数重新提交命令。