pgosweep

Se usa en la optimización guiada por perfiles para escribir todos los datos de perfil de un programa en ejecución en el archivo PGC.

Sintaxis

pgosweep [options] imagepgcfile

Parámetros

options
(Opcional) Los valores válidos para options son:

• /? o /help muestra el mensaje de ayuda.

• /reset restablece los recuentos a cero después del barrido. Este comportamiento es el predeterminado.

• /pid:n solo barre el PID especificado, donde n es el número de PID.

• /wait espera a que el PID especificado finalice antes de recopilar los recuentos.

• /onlyzero no guarda un archivo PGC, solo recuentos de cero.

• /pause pausa la colección de recuentos en el sistema.

• /resume reanuda la colección de recuentos en el sistema.

• /noreset conserva el recuento en las estructuras de datos del runtime.

image
La ruta de acceso completa de un archivo EXE o DLL que se creó mediante el uso de la opción /GENPROFILE, /FASTGENPROFILE o /LTCG:PGINSTRUMENT.

pgcfile
El archivo PGC en el que este comando escribe los recuentos de datos.

Comentarios

El comando pgosweep funciona en programas que se compilaron con la opción /GENPROFILE o /FASTGENPROFILE, o la opción /LTCG:PGINSTRUMENT en desuso. Interrumpe un programa en ejecución y escribe los datos del perfil en un archivo PGC nuevo. De forma predeterminada, el comando restablece los recuentos después de cada operación de escritura. Si especifica la opción /noreset, el comando registrará los valores, pero no los restablecerá en el programa en ejecución. Esta opción le proporciona datos duplicados si recupera los datos de perfil más adelante.

Un uso alternativo de pgosweep es recuperar información de perfil solo para el funcionamiento normal de la aplicación. Por ejemplo, podría ejecutar pgosweep poco después de iniciar la aplicación y descartar ese archivo. Este comando quitaría los datos de perfil asociados a los costos iniciales. A continuación, podría ejecutar pgosweep antes de finalizar la aplicación. Una vez hecho esto, los datos recopilados solo tendrían información de perfil desde el momento en que el usuario puede interactuar con el programa.

Cuando asigna un nombre a un archivo PGC (mediante el parámetro pgcfile), puede usar el formato estándar, que es appname!n.pgc. La n representa un valor numérico creciente para cada archivo. Si usa este formato, el compilador buscará automáticamente estos datos en la fase /LTCG /USEPROFILE o /LTCG:PGO. Si no usa el formato estándar, debe usar pgomgr para combinar los archivos PGC.

Nota:

Solo puede iniciar esta herramienta desde un símbolo del sistema para desarrolladores de Visual Studio. No puede iniciarla desde un símbolo del sistema ni desde el Explorador de archivos.

Para información sobre cómo capturar los datos de perfil desde dentro del archivo ejecutable, consulte el artículo PgoAutoSweep.

Ejemplo

En este comando de ejemplo, pgosweep escriba la información de perfil actual myapp.exe en myapp!1.pgc.

pgosweep myapp.exe myapp!1.pgc

Consulte también

Optimizaciones guiadas por perfiles
PgoAutoSweep