Partilhar via


Pgosweep

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

Sintaxe

pgosweep [opções] imagempgcfile

Parâmetros

Opções
(Opcional) Os valores válidos para as opções são:

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

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

  • /pid:n varre apenas o PID especificado, onde n é o número PID.

  • /wait aguarda que o PID especificado termine antes de recolher as contagens de dados.

  • /onlyzero não grava um ficheiro PGC, apenas ficheiros com contagem zero.

  • /pause interrompe a contagem no sistema.

  • /resume retoma a cobrança de contagem no sistema.

  • /noreset preserva a contagem nas estruturas de dados em tempo de execução.

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

pgcfile
O arquivo PGC onde este comando grava as contagens de dados.

Observações

O comando pgosweep é compatível com programas criados usando as opções /GENPROFILE, /FASTGENPROFILE ou a preterida /LTCG:PGINSTRUMENT. Ele interrompe um programa em execução e grava os dados do 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 /noreset opção, o comando registrará os valores, mas não os redefinirá no programa em execução. Esta opção fornece dados duplicados se você recuperar os dados de perfil mais tarde.

Um uso alternativo para pgosweep é recuperar informações de perfil apenas para o funcionamento normal do aplicativo. Por exemplo, você pode executar pgosweep logo após iniciar o aplicativo e descartar esse arquivo. Esse comando removeria os 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 apenas 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 ), você pode usar o formato padrão, que é appname!n.pgc. O n representa um valor numérico crescente para cada arquivo. Se utilizares este formato, o compilador encontrará automaticamente estes 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 a partir de um prompt de comando do desenvolvedor do Visual Studio. Não é possível iniciá-lo a partir de um prompt de comando do sistema ou do Explorador de Arquivos.

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

Exemplo

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

pgosweep myapp.exe myapp!1.pgc

Ver também

Profile-Guided Otimizações
PgoAutoSweep