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] image pgcfile
Parámetros
options
(Opcional) Los valores válidos para options son:
/?o/helpmuestra el mensaje de ayuda./resetrestablece los recuentos a cero después del barrido. Este comportamiento es el predeterminado./pid:nsolo barre el PID especificado, donde n es el número de PID./waitespera a que el PID especificado finalice antes de recopilar los recuentos./onlyzerono guarda un archivo PGC, solo recuentos de cero./pausepausa la colección de recuentos en el sistema./resumereanuda la colección de recuentos en el sistema./noresetconserva 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