pgosweep

  • Artykuł

Używany w optymalizacji z przewodnikiem profilu do zapisywania wszystkich danych profilu z uruchomionego programu do pliku PGC.

Składnia

pgosweep [opcje] obraz pgcfile

Parametry

Opcje
(Opcjonalnie) Prawidłowe wartości opcji to:

  • /? lub /help wyświetla komunikat pomocy.

  • /reset resetuje liczbę do zera po zamiataniu. To zachowanie jest domyślne.

  • /pid:n tylko zamiata określony identyfikator PID, gdzie n jest numerEM PID.

  • /wait przed zebraniem liczników czeka na zakończenie określonego identyfikatora PID.

  • /onlyzero program nie zapisuje pliku PGC, tylko zera.

  • /pause wstrzymuje zbieranie danych w systemie.

  • /resume wznawia zbieranie liczników w systemie.

  • /noreset zachowuje liczbę w strukturach danych środowiska uruchomieniowego.

obraz
Pełna ścieżka pliku EXE lub DLL, który został utworzony przy użyciu /GENPROFILEopcji , /FASTGENPROFILElub /LTCG:PGINSTRUMENT .

plik pgcfile
Plik PGC, w którym to polecenie zapisuje liczby danych.

Uwagi

Polecenie pgosweep działa na programach utworzonych przy użyciu /GENPROFILE opcji lub /FASTGENPROFILE lub przestarzałej /LTCG:PGINSTRUMENT opcji. Przerywa uruchomiony program i zapisuje dane profilu w nowym pliku PGC. Domyślnie polecenie resetuje liczbę po każdej operacji zapisu. Jeśli określisz /noreset opcję, polecenie zapisze wartości, ale nie zresetuje ich w uruchomionym programie. Ta opcja umożliwia zduplikowanie danych w przypadku późniejszego pobrania danych profilu.

Alternatywnym rozwiązaniem pgosweep jest pobranie informacji o profilu tylko dla normalnego działania aplikacji. Na przykład można uruchomić pgosweep wkrótce po uruchomieniu aplikacji i odrzucić ten plik. To polecenie spowoduje usunięcie danych profilu skojarzonych z kosztami uruchamiania. Następnie możesz uruchomić polecenie pgosweep przed zakończeniem aplikacji. Teraz zebrane dane zawierają informacje o profilu tylko od czasu, w jaki użytkownik może wchodzić w interakcję z programem.

Podczas nadawania nazwy pliku PGC (przy użyciu parametru pgcfile ) można użyć standardowego formatu , czyli appname!n.pgc. N reprezentuje rosnącą wartość liczbową dla każdego pliku. Jeśli używasz tego formatu, kompilator automatycznie znajdzie te dane w /LTCG /USEPROFILE fazie lub /LTCG:PGO . Jeśli nie używasz formatu standardowego, musisz użyć pgomgr polecenia , aby scalić pliki PGC.

Uwaga

To narzędzie można uruchomić tylko w wierszu polecenia dla deweloperów programu Visual Studio. Nie można go uruchomić z poziomu wiersza polecenia systemu lub z Eksplorator plików.

Aby uzyskać informacje na temat sposobu przechwytywania danych profilu z poziomu pliku wykonywalnego, zobacz PgoAutoSweep.

Przykład

W tym przykładowym poleceniu pgosweep zapisuje bieżące informacje o profilu dla elementu myapp.exe .myapp!1.pgc

pgosweep myapp.exe myapp!1.pgc

Zobacz też

Optymalizacje sterowane profilem
PgoAutoSweep