/CGTHREADS (threads du compilateur)

  • Article

Définit le nombre de threads de cl.exe à utiliser pour l'optimisation et la génération de code quand la génération de code durant l'édition de liens est spécifiée.

Syntaxe

/CGTHREADS:[1-8]

Arguments

numéro
Nombre maximal de threads utilisables par cl.exe, dans la plage de 1 à 8.

Notes

L’option /CGTHREADS spécifie le nombre maximal de threads cl.exe utilise en parallèle pour les phases d’optimisation et de génération de code de compilation lorsque la génération de code au moment de la liaison (/LTCG) est spécifiée. Par défaut, cl.exe utilise quatre threads, comme si /CGTHREADS :4 a été spécifié. Si un plus grand nombre de cœurs de processeur sont disponibles, une valeur number plus élevée peut améliorer les durées de génération.

Vous pouvez spécifier plusieurs niveaux de parallélisme pour une build. Le commutateur msbuild.exe /maxcpucount spécifie le nombre de processus MSBuild qui peuvent être exécutés en parallèle. L’indicateur du compilateur /MP (Build avec plusieurs processus) spécifie le nombre de processus cl.exe qui compilent simultanément les fichiers sources. L’option du compilateur /cgthreads spécifie le nombre de threads utilisés par chaque processus cl.exe. Le processeur ne pouvant pas exécuter simultanément plus de threads qu'il n'y a de cœurs de processeur, il est inutile de spécifier simultanément des valeurs plus élevées pour toutes ces options et cela peut même être contre-productif. Pour plus d’informations sur la création de projets en parallèle, consultez Génération de plusieurs projets en parallèle.

Pour définir cette option de l'éditeur de liens dans l'environnement de développement Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de Propriétés de configuration>Éditeur de liens>Ligne de commande.

  3. Modifiez la propriété Options supplémentaires pour inclure /CGTHREADS :number, où number est une valeur comprise entre 1 et 8, puis choisissez OK.

Pour définir cette option de l'éditeur de liens par programmation

Voir aussi

Options de l’éditeur de liens MSVC
Informations de référence sur l’éditeur de liens MSVC