pgosweep

  • 项目

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

语法

pgosweep [options] imagepgcfile

参数

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。

示例

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

pgosweep myapp.exe myapp!1.pgc

另请参阅

按配置优化
PgoAutoSweep