pgosweep

在按配置优化中使用,用于将正在运行的程序中的所有配置文件数据写入 PGC 文件。

语法

pgosweep [options] image pgcfile

参数

options
(可选)“选项”的有效值为

  • /?/help 显示帮助消息。

  • /reset 会在扫描后将计数重置为零。 此选项为默认行为。

  • /pid:n 仅扫描指定的 PID,其中 n 是 PID 编号。

  • /wait 等到指定的 PID 终止后再收集计数。

  • /onlyzero 不保存 PGC 文件,仅零计数。

  • /pause 暂停系统上的计数收集。

  • /resume 暂停系统上的计数收集。

  • /noreset 保留运行时数据结构中的计数。

image
使用 /GENPROFILE/FASTGENPROFILE/LTCG:PGINSTRUMENT 选项创建的 EXE 或 DLL 文件的完整路径。

pgcfile
此命令写出数据计数的 PGC 文件。

备注

pgosweep 命令适用于使用 /GENPROFILE/FASTGENPROFILE 选项或弃用的 /LTCG:PGINSTRUMENT 选项生成的程序。 它会中断正在运行的程序并将配置文件数据写入新的 PGC 文件。 默认情况下,该命令在每次写入操作后重置计数。 如果指定 /noreset 选项,该命令将记录这些值,但不会在运行的程序中重置它们。 如果稍后检索配置文件数据,此选项将为你提供重复数据。

pgosweep 的另一个用途是仅为应用程序的正常操作检索配置文件信息。 例如,可以在启动应用程序并放弃该文件后不久运行 pgosweep。 此命令将删除与启动成本相关的配置文件数据。 然后,可以在结束应用程序之前运行 pgosweep。 现在,收集的数据只有在用户可以与程序交互时才具有配置文件信息。

使用 pgcfile 参数命名 PGC 文件时,可以使用标准格式,即 appname!n.pgc。 n 表示每个文件增加的数值。 如果使用此格式,编译器将在 /LTCG /USEPROFILE/LTCG:PGO 阶段自动查找此数据。 如果不使用标准格式,则必须使用 pgomgr 合并 PGC 文件。

注意

只能从 Visual Studio 开发人员命令提示启动此工具。 不能从系统命令提示符或从文件资源管理器启动此工具。

有关如何从可执行文件中捕获配置文件数据的信息,请参阅 PgoAutoSweep

示例

在此示例命令中,pgosweepmyapp.exe 的当前配置文件信息写入 myapp!1.pgc

pgosweep myapp.exe myapp!1.pgc

另请参阅

按配置优化
PgoAutoSweep