pgosweep

Usado na otimização guiada por perfil para gravar todos os dados de perfil de um programa em execução no arquivo PGC.

Sintaxe

pgosweep [options] imagepgcfile

Parâmetros

options
(Opcional) Os valores válidos para options são:

• /? ou /help exibe a mensagem de ajuda.

• /reset redefine contagens para zero após a varredura. Esse é o comportamento padrão.

• /pid:n só varre o PID especificado, em que n é o número do PID.

• /wait espera que o PID especificado termine antes de coletar contagens.

• /onlyzero não salva um arquivo PGC, apenas zero contagens.

• /pause pausa a coleta de contagem no sistema.

• /resume pausa a coleta de contagem no sistema.

• /noreset preserva a contagem nas estruturas de dados de runtime.

imagem
O caminho completo de um arquivo EXE ou DLL que foi criado usando a opção /GENPROFILE, /FASTGENPROFILEou /LTCG:PGINSTRUMENT opção.

pgcfile
O arquivo PGC em que esse comando grava as contagens de dados.

Comentários

O comando pgosweep funciona em programas que foram criados usando a opção /GENPROFILE ou /FASTGENPROFILE, ou a opção obsoleta /LTCG:PGINSTRUMENT. Ele interrompe um programa em execução e grava os dados de perfil em um novo arquivo PGC. Por padrão, o comando redefine contagens após cada operação de gravação. Se você especificar a opção /noreset, o comando registrará os valores, mas não os redefinirá no programa em execução. Essa opção fornecerá dados duplicados se você recuperar os dados de perfil posteriormente.

Um uso alternativo para pgosweep é recuperar informações de perfil apenas para a operação normal do aplicativo. Por exemplo, você pode executar pgosweep logo após iniciar o aplicativo e descartar esse arquivo. Esse comando removeria dados de perfil associados aos custos de inicialização. Em seguida, você pode executar pgosweep antes de encerrar o aplicativo. Agora, os dados coletados têm informações de perfil somente a partir do momento em que o usuário pode interagir com o programa.

Quando você nomeia um arquivo PGC (usando o parâmetro pgcfile) pode usar o formato padrão, que é appname!n.pgc. O n representa um valor numérico crescente para cada arquivo. Se você usar esse formato, o compilador localizará automaticamente esses dados na fase /LTCG /USEPROFILE ou /LTCG:PGO. Se você não usar o formato padrão, deverá usar pgomgr para mesclar os arquivos PGC.

Observação

Você pode iniciar essa ferramenta somente por um prompt de comando do desenvolvedor do Visual Studio. Você não pode iniciá-lo por um prompt de comando do sistema ou pelo Explorador de Arquivos.

Para obter informações sobre como capturar os dados de perfil de dentro do executável, consulte PgoAutoSweep.

Exemplo

Neste comando de exemplo, pgosweep grava as informações de perfil atuais para myapp.exe a myapp!1.pgc.

pgosweep myapp.exe myapp!1.pgc

Confira também

Otimizações guiadas por perfil
PgoAutoSweep