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[opções] imagem pgcfile
Parâmetros
options
(Opcional) Os valores válidos para options são:
/?ou/helpexibe a mensagem de ajuda./resetredefine contagens para zero após a varredura. Esse é o comportamento padrão./pid:nsó varre o PID especificado, em que n é o número do PID./waitespera que o PID especificado termine antes de coletar contagens./onlyzeronão salva um arquivo PGC, apenas zero contagens./pausepausa a coleta de contagem no sistema./resumepausa a coleta de contagem no sistema./noresetpreserva 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