Partilhar via


Variáveis de ambiente para otimizações de Profile-Guided

Há três variáveis de ambiente que afetam os cenários de teste em uma imagem criada com /LTCG:PGI para otimizações guiadas por perfil:

  • PogoSafeMode especifica se o modo rápido ou o modo de segurança deve ser usado para a criação de perfil do aplicativo.

  • VCPROFILE_ALLOC_SCALE adiciona memória adicional para uso pelo criador de perfil.

  • VCPROFILE_PATH permite especificar a pasta usada para arquivos .pgc.

As variáveis de ambiente PogoSafeMode e VCPROFILE_ALLOC_SCALE foram preteridas a partir do Visual Studio 2015. As opções do vinculador /GENPROFILE ou /FASTGENPROFILE e /USEPROFILE especificam o mesmo comportamento do vinculador que essas variáveis de ambiente.

PogoSafeMode

Esta variável de ambiente foi preterida. Use os argumentos EXACT ou NOEXACT para /GENPROFILE ou /FASTGENPROFILE para controlar esse comportamento.

Desmarque ou defina a variável de ambiente PogoSafeMode para especificar se deseja usar o modo rápido ou o modo de segurança para criação de perfil de aplicativos em sistemas x86.

A otimização guiada por perfil (PGO) tem dois modos possíveis durante a fase de criação de perfil: modo rápido e modo de segurança. Quando a perfilagem está no modo rápido, usa-se a instrução INC para aumentar os contadores de dados. A instrução INC é mais rápida, mas não é thread-safe. Quando a perfilagem está no modo de segurança, usa a instrução LOCK INC para aumentar os contadores de dados. A instrução LOCK INC tem a mesma funcionalidade que a instrução INC e é thread-safe, mas é mais lenta do que a instrução INC .

Por padrão, a criação de perfil PGO opera no modo rápido. PogoSafeMode só é necessário se você quiser usar o modo de segurança.

Para executar a criação de perfil PGO no modo de segurança, você deve usar a variável de ambiente PogoSafeMode ou a opção de vinculador /PogoSafeMode, dependendo do sistema. Se você estiver executando a criação de perfil em um computador x64, deverá usar a opção de vinculador. Se você estiver executando a criação de perfil em um computador x86, poderá usar a opção vinculadora ou definir a variável de ambiente PogoSafeMode para qualquer valor antes de iniciar o processo de otimização.

Sintaxe PogoSafeMode

definir PogoSafeMode[=value]

Defina PogoSafeMode para qualquer valor para ativar o modo de segurança. Defina sem um valor para limpar um valor anterior e reativar o modo rápido.

VCPROFILE_ALLOC_SCALE

Esta variável de ambiente foi preterida. Use os argumentos MEMMIN e MEMMAX para /GENPROFILE ou /FASTGENPROFILE para controlar esse comportamento.

Modifique a variável de ambiente VCPROFILE_ALLOC_SCALE para alterar a quantidade de memória alocada para armazenar os dados de perfil. Em casos raros, não haverá memória suficiente disponível para dar suporte à coleta de dados de perfil ao executar cenários de teste. Nesses casos, você pode aumentar a quantidade de memória definindo VCPROFILE_ALLOC_SCALE. Se você receber uma mensagem de erro durante uma execução de teste que indica que você tem memória insuficiente, atribua um valor maior a VCPROFILE_ALLOC_SCALE, até que o teste seja concluído sem erros de falta de memória.

Sintaxe de VCPROFILE_ALLOC_SCALE

definir VCPROFILE_ALLOC_SCALE[=scale_value]

O parâmetro scale_value é um fator de dimensionamento para a quantidade de memória que você deseja para executar cenários de teste. O padrão é 1. Por exemplo, esta linha de comando define o fator de escala como 2:

set VCPROFILE_ALLOC_SCALE=2

VCPROFILE_PATH

Use a variável de ambiente VCPROFILE_PATH para especificar o diretório para criar arquivos .pgc. Por padrão, os arquivos .pgc são criados no mesmo diretório que o binário que está sendo perfilado. No entanto, se o caminho absoluto do binário não existir, como pode ser o caso quando você executa cenários de perfil em uma máquina diferente de onde o binário foi construído, você pode definir VCPROFILE_PATH para um caminho que existe na máquina de destino.

Sintaxe de VCPROFILE_PATH

definir VCPROFILE_PATH[=caminho]

Defina o parâmetro path para o caminho do diretório no qual adicionar arquivos .pgc. Por exemplo, esta linha de comando define a pasta como C:\profile:

set VCPROFILE_PATH=c:\profile

Ver também

Profile-Guided Otimizações
/GENPROFILE e /FASTGENPROFILE
/USEPROFILE