Options¶
-C <initial-cache>
Préchargez un script pour remplir le cache.
Lorsque cmake est exécuté pour la première fois dans un arbre de construction vide, il crée aCMakeCache.fichier txt et le remplit avec des paramètres personnalisables pour le projet. Cette option peut être utilisée pour spécifier un fichier à partir duquel charger des entrées de cache avant le premier passage dans les fichiers de liste de fabrication du projet. Les entrées chargées ont priorité sur les valeurs par défaut du projet. Le fichier donné doit être un script CMake contenant des commandes SET qui utilisent l’option CACHE, pas un fichier au format acache.
-D <var>:<type>=<value>
Créez une entrée de cache cmake.
Lorsque cmake est exécuté pour la première fois dans un arbre de construction vide, il crée aCMakeCache.fichier txt et le remplit avec des paramètres personnalisables pour le projet. Cette option peut être utilisée pour spécifier un paramètre quiprend la priorité sur la valeur par défaut du projet. L’option peut être activée pour autant d’entrées de cache que vous le souhaitez.
-U <globbing_expr>
Supprime les entrées correspondantes du cache CMake.
Cette option peut être utilisée pour supprimer une ou plusieurs variables de theCMakeCache.fichier txt, expressions globbing utilisant * et? est pris en charge. L’option peut être répétée pour autant d’entrées de cache quedesired.
A utiliser avec précaution, vous pouvez réaliser votre CMakeCache.txt ne fonctionne pas.
-G <generator-name>
Spécifiez un générateur de système de génération.
CMake peut prendre en charge plusieurs systèmes de génération natifs sur certainplatforms. Un générateur est responsable de la génération d’un particuliersystème de construction. Les noms de générateurs possibles sont spécifiés dans la section Générateurs.
-T <toolset-name>
Spécifiez le nom du jeu d’outils s’il est pris en charge par le générateur.
Certains générateurs CMake prennent en charge un nom de jeu d’outils à donner au système de construction initial pour choisir un compilateur. Ceci est pris en charge uniquement sur les générateurs spécifiques:
Visual Studio >= 10Xcode >= 3.0
Consultez la documentation du système de génération natif pour connaître les noms de jeu d’outils autorisés.
-A <platform-name>
Spécifiez le nom de la plate-forme si elle est prise en charge par le générateur.
Certains générateurs CMake prennent en charge un nom de plate-forme à donner au système de construction initial pour choisir un compilateur ou un SDK. Ceci est pris en charge uniquement sur les générateurs spécifiques:
Visual Studio >= 8
Consultez la documentation du système de génération natif pour connaître les noms de plate-forme autorisés.
-Wno-dev
Supprime les avertissements des développeurs.
Supprime les avertissements destinés à l’auteur de theCMakeLists.fichiers txt.
-Wdev
Activer les avertissements des développeurs.
Activez les avertissements destinés à l’auteur des listes CMakeLists.fichiers txt.
-E
Mode de commande CMake.
Pour une véritable indépendance de la plate-forme, CMake fournit une liste de commandesqui peut être utilisée sur tous les systèmes. Exécutez avec l’aide de -E pour l’information d’utilisation. Les commandes disponibles sont: chdir, compare_files, copy, copy_directory, copy_if_different, echo, echo_append, env, environment, make_directory, md5sum, remove, remove_directory, rename, sleep, tar, time, touch, touch_nocreate. De plus, certaines commandes spécifiques à la platformesont disponibles. Sous Windows : delete_regv, write_regv. OnUNIX: create_symlink.
-L
Liste les variables mises en cache non avancées.
Les variables de cache de liste exécuteront CMake et répertorieront toutes les variables du cache CMake qui ne sont pas marquées comme INTERNES ou AVANCÉES. Cela affichera efficacement les paramètres CMake actuels, qui peuvent ensuite être changés avec l’option -D. La modification de certaines variables peut entraîner la création de plus de variables. Si A est spécifié, alors il affichera également des variables avancées. Si H est spécifié, il affichera également de l’aide pour chaque variable.
--build <dir>
Créez un arbre binaire de projet généré par CMake.
Ceci fait abstraction de l’interface de ligne de commande d’un outil de génération natif avec les options suivantes:
<dir> = Project binary directory to be built.--target <tgt> = Build <tgt> instead of default targets.--config <cfg> = For multi-configuration tools, choose <cfg>.--clean-first = Build target 'clean' first, then build. (To clean only, use --target 'clean'.)--use-stderr = Ignored. Behavior is default in CMake >= 3.0.-- = Pass remaining options to the native tool.
Exécutez cmake-build sans options pour une aide rapide.
-N
Mode d’affichage uniquement.
Ne chargez que le cache. N’exécutez pas réellement configure et generatesteps.
-P <file>
Mode script de processus.
Traitez le fichier cmake donné comme un script écrit en CMakelanguage. Aucune étape de configuration ou de génération n’est effectuée et le cache n’est pas modifié. Si les variables sont définies à l’aide de -D, cela doit êtreun avant l’argument -P.
--find-package
S’exécute en mode de configuration pkg.
Recherchez un paquet à l’aide de find_package() et imprimez les drapeaux résultants à la sortie standard. Cela peut être utilisé pour utiliser cmake au lieu de pkg-config pour trouver des bibliothèques installées dans des projets simples basés sur Makefile ou des projets basés sur inautoconf (via share/aclocal/cmake.m4).
--graphviz=
Générer graphviz de dépendances, voir CMakeGraphVizOptions.cmake pour plus.
Génère un fichier d’entrée graphviz qui contiendra toutes les dépendances de bibliothèque et exécutables du projet. Voir la documentation pouRMakeGraphVizOptions.cmake pour plus de détails.
--system-information
Videz des informations sur ce système.
Videz un large éventail d’informations sur le système actuel. S’il est exécuté en haut d’une arborescence binaire pour un projet CMake, il déposera des informations supplémentaires telles que le cache, les fichiers journaux, etc.
--debug-trycompile
Ne supprimez pas l’arborescence de construction try_compile. Utile uniquement sur un try_compile à la fois.
Ne supprimez pas les fichiers et répertoires créés pour try_compilecalls. Ceci est utile lors du débogage de try_compiles ayant échoué. Cela peut cependant changer les résultats des compilations try, car les anciens fichiers indésirables d’une compilation try précédente peuvent entraîner un test différent à passer ou à échouer incorrectement. Cette option est mieux utilisée pour une compilation d’essai à la fois, et uniquement lors du débogage.
--debug-output
Mettez cmake en mode débogage.
Imprime des éléments supplémentaires pendant l’exécution de cmake comme des traces de pile avec des appels de message (send_error).
--trace
Mettez cmake en mode trace.
Affiche une trace de tous les appels effectués et d’où viennent les appels withmessage(send_error).
--warn-uninitialized
Avertir des valeurs non initialisées.
Affiche un avertissement lorsqu’une variable non initialisée est utilisée.
--warn-unused-vars
Avertir des variables inutilisées.
Recherche les variables déclarées ou définies, mais non utilisées.
--no-warn-unused-cli
Ne pas avertir des options de ligne de commande.
Ne trouve pas les variables déclarées sur la ligne de commande, mais non utilisées.
--check-system-vars
Trouvez des problèmes d’utilisation des variables dans les fichiers système.
Normalement, les variables inutilisées et non initialisées sont recherchées uniquement dans CMAKE_SOURCE_DIR et CMAKE_BINARY_DIR. Cet indicateur indique également à CMake towarn d’autres fichiers.
--help,-help,-usage,-h,-H,/?
Imprimer les informations d’utilisation et quitter.
Utilisation décrit l’interface de ligne de commande de base et ses options.
--version,-version,/V
Afficher la bannière nom/version du programme et quitter.
Si un fichier est spécifié, la version y est écrite.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-full
Imprimez tous les manuels d’aide et quittez.
Tous les manuels sont imprimés dans un format texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-manual <man>
Imprimez un manuel d’aide et quittez.
Le manuel spécifié est imprimé dans un format texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-manual-list
Listez les manuels d’aide disponibles et quittez.
La liste contient tous les manuels pour lesquels une aide peut être obtenue en utilisant l’option --help-manual suivie d’un nom de manuel.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-command <cmd>
Affiche l’aide pour une commande et quitte.
La saisie manuelle cmake-commands(7) pour <cmd> est imprimée dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-command-list
Listez les commandes avec l’aide disponible et quittez.
La liste contient toutes les commandes pour lesquelles une aide peut être obtenue en utilisant l’option --help-command suivie d’un nom de commande.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-commands
Imprimer le manuel des commandes cmake et quitter.
Le manuel cmake-commands(7) est imprimé dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-module <mod>
Imprimer l’aide pour un module et quitter.
La saisie manuelle cmake-modules(7) pour <mod> est imprimée dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-module-list
Listez les modules avec l’aide disponible et quittez.
La liste contient tous les modules pour lesquels une aide peut être obtenue en utilisant l’option --help-module suivie d’un nom de module.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-modules
Imprimer le manuel des modules cmake et quitter.
Le manuel cmake-modules(7) est imprimé dans un format texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-policy <cmp>
Imprimer l’aide pour une stratégie et quitter.
La saisie manuelle cmake-policies(7) pour <cmp> est imprimée dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-policy-list
Listez les stratégies avec l’aide disponible et quittez.
La liste contient toutes les stratégies pour lesquelles une aide peut être obtenue en utilisant l’option --help-policy suivie d’un nom de stratégie.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-policies
Imprimer le manuel des stratégies cmake et quitter.
Le manuel cmake-policies(7) est imprimé dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-property <prop>
Imprimer l’aide pour une propriété et quitter.
Les cmake-properties(7) entrées manuelles pour <prop> sont imprimées dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-property-list
Lister les propriétés avec l’aide disponible et quitter.
La liste contient toutes les propriétés pour lesquelles une aide peut être obtenue en utilisant l’option --help-property suivie d’un nom de propriété.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-properties
Imprimer le manuel des propriétés cmake et quitter.
Le manuel cmake-properties(7) est imprimé dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-variable <var>
Imprimer l’aide pour une variable et quitter.
La saisie manuelle cmake-variables(7) pour <var> est imprimée dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-variable-list
Lister les variables avec l’aide disponible et quitter.
La liste contient toutes les variables pour lesquelles une aide peut être obtenue en utilisant l’option --help-variable suivie d’un nom de variable.L’aide est imprimée sur une ile nommée < f > si elle est donnée.
--help-variables
Imprimer le manuel des variables cmake et quitter.
Le manuel cmake-variables(7) est imprimé dans un format de texte lisible par l’homme.L’aide est imprimée sur une ile nommée < f > si elle est donnée.