pgosweep
Utilisé dans l’optimisation guidée par profil pour écrire toutes les données de profil d’un programme en cours d’exécution dans le fichier PGC.
Syntaxe
pgosweep[options] image pgcfile
Paramètres
options
(Facultatif) Les valeurs valides pour les options sont les suivantes :
/?ou/helpaffiche le message de l’aide./resetréinitialise le nombre égal à zéro après le rangement. Il s’agit du comportement par défaut./pid:nbalaye uniquement le PID spécifié, où n est le numéro PID./waitattend que le PID spécifié se termine avant de collecter des données./onlyzeron’enregistre pas un fichier PGC, seul zéro comptes./pausesuspend la collecte du nombre sur le système./resumepoursuit la collecte du nombre sur le système./noresetconserve le nombre dans les structures de données runtime.
image
Chemin complet d’un fichier EXE ou DLL créé à l’aide de l’option /GENPROFILE, /FASTGENPROFILEou /LTCG:PGINSTRUMENT.
pgcfile
Fichier PGC dans lequel cette commande écrit le nombre de données.
Notes
La commande pgosweep fonctionne sur les programmes créés à l’aide de l’option /GENPROFILE ou /FASTGENPROFILE, ou de l’option /LTCG:PGINSTRUMENT déconseillée. Il interrompt un programme en cours d’exécution et écrit les données de profil dans un nouveau fichier PGC. Par défaut, la commande réinitialise le nombre après chaque opération d’écriture. Si vous spécifiez l’option /noreset, la commande enregistre les valeurs, mais ne les réinitialise pas dans le programme en cours d’exécution. Cette option vous donne des données en double si vous récupérez les données de profil ultérieurement.
Une autre utilisation pour pgosweep consiste à récupérer des informations de profil uniquement pour le fonctionnement normal de l’application. Par exemple, vous pouvez exécuter pgosweep peu après le démarrage de l’application et ignorer ce fichier. Cette commande supprime les données de profil associées aux coûts de démarrage. Ensuite, vous pouvez exécuter pgosweep avant de mettre fin à l’application. À présent, les données collectées ont des informations de profil uniquement à partir du moment où l’utilisateur peut interagir avec le programme.
Lorsque vous nommez un fichier PGC (à l’aide du paramètre pgcfile), vous pouvez utiliser le format standard, qui est appname!n.pgc. Le n représente une valeur numérique croissante pour chaque fichier. Si vous utilisez ce format, le compilateur trouve automatiquement ces données dans la phase /LTCG /USEPROFILE ou /LTCG:PGO. Si vous n’utilisez pas le format standard, vous devez utiliser pgomgr pour fusionner les fichiers PGC.
Remarque
Vous ne pouvez démarrer cet outil qu’à partir d’une invite de commandes du développeur Visual Studio. Vous ne pouvez pas le démarrer à partir d’une invite de commandes système ni de l’Explorateur de fichiers.
Pour plus d’informations sur la capture des données de profil à partir de votre exécutable, consultez PgoAutoSweep.
Exemple
Dans cet exemple de commande, pgosweep écrit les informations de profil actuelles pour myapp.exe dans myapp!1.pgc.
pgosweep myapp.exe myapp!1.pgc