pgosweep

  • Статья

Используется в профильной оптимизации для записи всех данных профиля из выполняющейся программы в PGC-файл.

Синтаксис

pgosweep [параметры] изображениеpgcfile

Параметры

options
(Необязательно) Допустимые значения для options:

  • /? или /help — выводит справочное сообщение.

  • /reset сбрасывает счетчики до нуля после очистки. Поведение по умолчанию.

  • /pid:n очищает только указанный идентификатор PID, где n — номер PID.

  • /wait ожидает завершения процесса с указанным PID перед сбором данных счетчика.

  • /onlyzero не сохраняет PGC-файл, только нулевые значения счетчиков.

  • /pause приостанавливает сбор данных счетчиков в системе.

  • /resume возобновляет сбор данных счетчиков в системе.

  • /noreset сохраняет счетчик в структурах данных среды выполнения.

Изображение
Полный путь к файлу EXE или DLL, созданному с помощью параметра /GENPROFILE, /FASTGENPROFILE или /LTCG:PGINSTRUMENT.

pgcfile
Файл PGC, в который эта команда записывает счетчики данных.

Замечания

Команда pgosweep работает с программами, созданными с помощью параметра /GENPROFILE или /FASTGENPROFILE либо устаревшего параметра /LTCG:PGINSTRUMENT. Она прерывает выполнение программы и записывает данные профиля в новый PGC-файл. По умолчанию команда сбрасывает счетчики после каждой операции записи. Если указать параметр /noreset, команда будет записывать значения, но не будет сбрасывать их в выполняющейся программе. Этот параметр приводит к дублированию данных при последующем извлечении данных профиля.

Альтернативный вариант использования pgosweep — получение данных профиля только для нормального режима работы приложения. Например, можно выполнить команду pgosweep сразу же после запуска приложения и удалить этот файл. Эта команда удаляет данные профиля, связанные с запуском. После этого можно выполнить pgosweep перед завершением работы приложения. В результате будут собраны данные профиля только с момента, когда пользователь получил возможность взаимодействовать с программой.

При присвоении имени PGC-файлу (с помощью параметра pgcfile) можно использовать стандартный формат, то есть 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