1.. cmake-manual-description: CMake Variables Reference 2 3cmake-variables(7) 4****************** 5 6.. only:: html 7 8 .. contents:: 9 10This page documents variables that are provided by CMake 11or have meaning to CMake when set by project code. 12 13For general information on variables, see the 14:ref:`Variables <CMake Language Variables>` 15section in the cmake-language manual. 16 17.. include:: ID_RESERVE.txt 18 19Variables that Provide Information 20================================== 21 22.. toctree:: 23 :maxdepth: 1 24 25 /variable/CMAKE_AR 26 /variable/CMAKE_ARGC 27 /variable/CMAKE_ARGV0 28 /variable/CMAKE_BINARY_DIR 29 /variable/CMAKE_BUILD_TOOL 30 /variable/CMAKE_CACHE_MAJOR_VERSION 31 /variable/CMAKE_CACHE_MINOR_VERSION 32 /variable/CMAKE_CACHE_PATCH_VERSION 33 /variable/CMAKE_CACHEFILE_DIR 34 /variable/CMAKE_CFG_INTDIR 35 /variable/CMAKE_COMMAND 36 /variable/CMAKE_CPACK_COMMAND 37 /variable/CMAKE_CROSSCOMPILING 38 /variable/CMAKE_CROSSCOMPILING_EMULATOR 39 /variable/CMAKE_CTEST_COMMAND 40 /variable/CMAKE_CURRENT_BINARY_DIR 41 /variable/CMAKE_CURRENT_FUNCTION 42 /variable/CMAKE_CURRENT_FUNCTION_LIST_DIR 43 /variable/CMAKE_CURRENT_FUNCTION_LIST_FILE 44 /variable/CMAKE_CURRENT_FUNCTION_LIST_LINE 45 /variable/CMAKE_CURRENT_LIST_DIR 46 /variable/CMAKE_CURRENT_LIST_FILE 47 /variable/CMAKE_CURRENT_LIST_LINE 48 /variable/CMAKE_CURRENT_SOURCE_DIR 49 /variable/CMAKE_DEBUG_TARGET_PROPERTIES 50 /variable/CMAKE_DIRECTORY_LABELS 51 /variable/CMAKE_DL_LIBS 52 /variable/CMAKE_DOTNET_TARGET_FRAMEWORK 53 /variable/CMAKE_DOTNET_TARGET_FRAMEWORK_VERSION 54 /variable/CMAKE_EDIT_COMMAND 55 /variable/CMAKE_EXECUTABLE_SUFFIX 56 /variable/CMAKE_EXECUTABLE_SUFFIX_LANG 57 /variable/CMAKE_EXTRA_GENERATOR 58 /variable/CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES 59 /variable/CMAKE_FIND_DEBUG_MODE 60 /variable/CMAKE_FIND_PACKAGE_NAME 61 /variable/CMAKE_FIND_PACKAGE_SORT_DIRECTION 62 /variable/CMAKE_FIND_PACKAGE_SORT_ORDER 63 /variable/CMAKE_GENERATOR 64 /variable/CMAKE_GENERATOR_INSTANCE 65 /variable/CMAKE_GENERATOR_PLATFORM 66 /variable/CMAKE_GENERATOR_TOOLSET 67 /variable/CMAKE_IMPORT_LIBRARY_PREFIX 68 /variable/CMAKE_IMPORT_LIBRARY_SUFFIX 69 /variable/CMAKE_JOB_POOL_COMPILE 70 /variable/CMAKE_JOB_POOL_LINK 71 /variable/CMAKE_JOB_POOL_PRECOMPILE_HEADER 72 /variable/CMAKE_JOB_POOLS 73 /variable/CMAKE_LANG_COMPILER_AR 74 /variable/CMAKE_LANG_COMPILER_FRONTEND_VARIANT 75 /variable/CMAKE_LANG_COMPILER_RANLIB 76 /variable/CMAKE_LANG_LINK_LIBRARY_SUFFIX 77 /variable/CMAKE_LINK_LIBRARY_SUFFIX 78 /variable/CMAKE_LINK_SEARCH_END_STATIC 79 /variable/CMAKE_LINK_SEARCH_START_STATIC 80 /variable/CMAKE_MAJOR_VERSION 81 /variable/CMAKE_MAKE_PROGRAM 82 /variable/CMAKE_MATCH_COUNT 83 /variable/CMAKE_MATCH_n 84 /variable/CMAKE_MINIMUM_REQUIRED_VERSION 85 /variable/CMAKE_MINOR_VERSION 86 /variable/CMAKE_NETRC 87 /variable/CMAKE_NETRC_FILE 88 /variable/CMAKE_PARENT_LIST_FILE 89 /variable/CMAKE_PATCH_VERSION 90 /variable/CMAKE_PROJECT_DESCRIPTION 91 /variable/CMAKE_PROJECT_HOMEPAGE_URL 92 /variable/CMAKE_PROJECT_NAME 93 /variable/CMAKE_PROJECT_VERSION 94 /variable/CMAKE_PROJECT_VERSION_MAJOR 95 /variable/CMAKE_PROJECT_VERSION_MINOR 96 /variable/CMAKE_PROJECT_VERSION_PATCH 97 /variable/CMAKE_PROJECT_VERSION_TWEAK 98 /variable/CMAKE_RANLIB 99 /variable/CMAKE_ROOT 100 /variable/CMAKE_RULE_MESSAGES 101 /variable/CMAKE_SCRIPT_MODE_FILE 102 /variable/CMAKE_SHARED_LIBRARY_PREFIX 103 /variable/CMAKE_SHARED_LIBRARY_SUFFIX 104 /variable/CMAKE_SHARED_MODULE_PREFIX 105 /variable/CMAKE_SHARED_MODULE_SUFFIX 106 /variable/CMAKE_SIZEOF_VOID_P 107 /variable/CMAKE_SKIP_INSTALL_RULES 108 /variable/CMAKE_SKIP_RPATH 109 /variable/CMAKE_SOURCE_DIR 110 /variable/CMAKE_STATIC_LIBRARY_PREFIX 111 /variable/CMAKE_STATIC_LIBRARY_SUFFIX 112 /variable/CMAKE_Swift_MODULE_DIRECTORY 113 /variable/CMAKE_Swift_NUM_THREADS 114 /variable/CMAKE_TOOLCHAIN_FILE 115 /variable/CMAKE_TWEAK_VERSION 116 /variable/CMAKE_VERBOSE_MAKEFILE 117 /variable/CMAKE_VERSION 118 /variable/CMAKE_VS_DEVENV_COMMAND 119 /variable/CMAKE_VS_MSBUILD_COMMAND 120 /variable/CMAKE_VS_NsightTegra_VERSION 121 /variable/CMAKE_VS_PLATFORM_NAME 122 /variable/CMAKE_VS_PLATFORM_NAME_DEFAULT 123 /variable/CMAKE_VS_PLATFORM_TOOLSET 124 /variable/CMAKE_VS_PLATFORM_TOOLSET_CUDA 125 /variable/CMAKE_VS_PLATFORM_TOOLSET_CUDA_CUSTOM_DIR 126 /variable/CMAKE_VS_PLATFORM_TOOLSET_HOST_ARCHITECTURE 127 /variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION 128 /variable/CMAKE_VS_TARGET_FRAMEWORK_VERSION 129 /variable/CMAKE_VS_TARGET_FRAMEWORK_IDENTIFIER 130 /variable/CMAKE_VS_TARGET_FRAMEWORK_TARGETS_VERSION 131 /variable/CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION 132 /variable/CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION_MAXIMUM 133 /variable/CMAKE_XCODE_BUILD_SYSTEM 134 /variable/CMAKE_XCODE_PLATFORM_TOOLSET 135 /variable/PROJECT-NAME_BINARY_DIR 136 /variable/PROJECT-NAME_DESCRIPTION 137 /variable/PROJECT-NAME_HOMEPAGE_URL 138 /variable/PROJECT-NAME_IS_TOP_LEVEL 139 /variable/PROJECT-NAME_SOURCE_DIR 140 /variable/PROJECT-NAME_VERSION 141 /variable/PROJECT-NAME_VERSION_MAJOR 142 /variable/PROJECT-NAME_VERSION_MINOR 143 /variable/PROJECT-NAME_VERSION_PATCH 144 /variable/PROJECT-NAME_VERSION_TWEAK 145 /variable/PROJECT_BINARY_DIR 146 /variable/PROJECT_DESCRIPTION 147 /variable/PROJECT_HOMEPAGE_URL 148 /variable/PROJECT_IS_TOP_LEVEL 149 /variable/PROJECT_NAME 150 /variable/PROJECT_SOURCE_DIR 151 /variable/PROJECT_VERSION 152 /variable/PROJECT_VERSION_MAJOR 153 /variable/PROJECT_VERSION_MINOR 154 /variable/PROJECT_VERSION_PATCH 155 /variable/PROJECT_VERSION_TWEAK 156 157Variables that Change Behavior 158============================== 159 160.. toctree:: 161 :maxdepth: 1 162 163 /variable/BUILD_SHARED_LIBS 164 /variable/CMAKE_ABSOLUTE_DESTINATION_FILES 165 /variable/CMAKE_APPBUNDLE_PATH 166 /variable/CMAKE_AUTOMOC_RELAXED_MODE 167 /variable/CMAKE_BACKWARDS_COMPATIBILITY 168 /variable/CMAKE_BUILD_TYPE 169 /variable/CMAKE_CLANG_VFS_OVERLAY 170 /variable/CMAKE_CODEBLOCKS_COMPILER_ID 171 /variable/CMAKE_CODEBLOCKS_EXCLUDE_EXTERNAL_FILES 172 /variable/CMAKE_CODELITE_USE_TARGETS 173 /variable/CMAKE_COLOR_MAKEFILE 174 /variable/CMAKE_CONFIGURATION_TYPES 175 /variable/CMAKE_DEPENDS_IN_PROJECT_ONLY 176 /variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName 177 /variable/CMAKE_ECLIPSE_GENERATE_LINKED_RESOURCES 178 /variable/CMAKE_ECLIPSE_GENERATE_SOURCE_PROJECT 179 /variable/CMAKE_ECLIPSE_MAKE_ARGUMENTS 180 /variable/CMAKE_ECLIPSE_RESOURCE_ENCODING 181 /variable/CMAKE_ECLIPSE_VERSION 182 /variable/CMAKE_ERROR_DEPRECATED 183 /variable/CMAKE_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION 184 /variable/CMAKE_EXECUTE_PROCESS_COMMAND_ECHO 185 /variable/CMAKE_EXPORT_COMPILE_COMMANDS 186 /variable/CMAKE_EXPORT_PACKAGE_REGISTRY 187 /variable/CMAKE_EXPORT_NO_PACKAGE_REGISTRY 188 /variable/CMAKE_FIND_APPBUNDLE 189 /variable/CMAKE_FIND_FRAMEWORK 190 /variable/CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX 191 /variable/CMAKE_FIND_LIBRARY_PREFIXES 192 /variable/CMAKE_FIND_LIBRARY_SUFFIXES 193 /variable/CMAKE_FIND_NO_INSTALL_PREFIX 194 /variable/CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY 195 /variable/CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY 196 /variable/CMAKE_FIND_PACKAGE_PREFER_CONFIG 197 /variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS 198 /variable/CMAKE_FIND_PACKAGE_WARN_NO_MODULE 199 /variable/CMAKE_FIND_ROOT_PATH 200 /variable/CMAKE_FIND_ROOT_PATH_MODE_INCLUDE 201 /variable/CMAKE_FIND_ROOT_PATH_MODE_LIBRARY 202 /variable/CMAKE_FIND_ROOT_PATH_MODE_PACKAGE 203 /variable/CMAKE_FIND_ROOT_PATH_MODE_PROGRAM 204 /variable/CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH 205 /variable/CMAKE_FIND_USE_CMAKE_PATH 206 /variable/CMAKE_FIND_USE_CMAKE_SYSTEM_PATH 207 /variable/CMAKE_FIND_USE_PACKAGE_REGISTRY 208 /variable/CMAKE_FIND_USE_PACKAGE_ROOT_PATH 209 /variable/CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH 210 /variable/CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY 211 /variable/CMAKE_FRAMEWORK_PATH 212 /variable/CMAKE_IGNORE_PATH 213 /variable/CMAKE_INCLUDE_DIRECTORIES_BEFORE 214 /variable/CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE 215 /variable/CMAKE_INCLUDE_PATH 216 /variable/CMAKE_INSTALL_DEFAULT_COMPONENT_NAME 217 /variable/CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS 218 /variable/CMAKE_INSTALL_MESSAGE 219 /variable/CMAKE_INSTALL_PREFIX 220 /variable/CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT 221 /variable/CMAKE_LIBRARY_PATH 222 /variable/CMAKE_LINK_DIRECTORIES_BEFORE 223 /variable/CMAKE_MFC_FLAG 224 /variable/CMAKE_MAXIMUM_RECURSION_DEPTH 225 /variable/CMAKE_MESSAGE_CONTEXT 226 /variable/CMAKE_MESSAGE_CONTEXT_SHOW 227 /variable/CMAKE_MESSAGE_INDENT 228 /variable/CMAKE_MESSAGE_LOG_LEVEL 229 /variable/CMAKE_MODULE_PATH 230 /variable/CMAKE_POLICY_DEFAULT_CMPNNNN 231 /variable/CMAKE_POLICY_WARNING_CMPNNNN 232 /variable/CMAKE_PREFIX_PATH 233 /variable/CMAKE_PROGRAM_PATH 234 /variable/CMAKE_PROJECT_INCLUDE 235 /variable/CMAKE_PROJECT_INCLUDE_BEFORE 236 /variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE 237 /variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE_BEFORE 238 /variable/CMAKE_REQUIRE_FIND_PACKAGE_PackageName 239 /variable/CMAKE_SKIP_INSTALL_ALL_DEPENDENCY 240 /variable/CMAKE_STAGING_PREFIX 241 /variable/CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS 242 /variable/CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE 243 /variable/CMAKE_SUPPRESS_REGENERATION 244 /variable/CMAKE_SYSROOT 245 /variable/CMAKE_SYSROOT_COMPILE 246 /variable/CMAKE_SYSROOT_LINK 247 /variable/CMAKE_SYSTEM_APPBUNDLE_PATH 248 /variable/CMAKE_SYSTEM_FRAMEWORK_PATH 249 /variable/CMAKE_SYSTEM_IGNORE_PATH 250 /variable/CMAKE_SYSTEM_INCLUDE_PATH 251 /variable/CMAKE_SYSTEM_LIBRARY_PATH 252 /variable/CMAKE_SYSTEM_PREFIX_PATH 253 /variable/CMAKE_SYSTEM_PROGRAM_PATH 254 /variable/CMAKE_TLS_CAINFO 255 /variable/CMAKE_TLS_VERIFY 256 /variable/CMAKE_USER_MAKE_RULES_OVERRIDE 257 /variable/CMAKE_WARN_DEPRECATED 258 /variable/CMAKE_WARN_ON_ABSOLUTE_INSTALL_DESTINATION 259 /variable/CMAKE_XCODE_GENERATE_SCHEME 260 /variable/CMAKE_XCODE_GENERATE_TOP_LEVEL_PROJECT_ONLY 261 /variable/CMAKE_XCODE_LINK_BUILD_PHASE_MODE 262 /variable/CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER 263 /variable/CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN 264 /variable/CMAKE_XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING 265 /variable/CMAKE_XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER 266 /variable/CMAKE_XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS 267 /variable/CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE 268 /variable/CMAKE_XCODE_SCHEME_ENVIRONMENT 269 /variable/CMAKE_XCODE_SCHEME_GUARD_MALLOC 270 /variable/CMAKE_XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP 271 /variable/CMAKE_XCODE_SCHEME_MALLOC_GUARD_EDGES 272 /variable/CMAKE_XCODE_SCHEME_MALLOC_SCRIBBLE 273 /variable/CMAKE_XCODE_SCHEME_MALLOC_STACK 274 /variable/CMAKE_XCODE_SCHEME_THREAD_SANITIZER 275 /variable/CMAKE_XCODE_SCHEME_THREAD_SANITIZER_STOP 276 /variable/CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER 277 /variable/CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP 278 /variable/CMAKE_XCODE_SCHEME_WORKING_DIRECTORY 279 /variable/CMAKE_XCODE_SCHEME_ZOMBIE_OBJECTS 280 /variable/PackageName_ROOT 281 282Variables that Describe the System 283================================== 284 285.. toctree:: 286 :maxdepth: 1 287 288 /variable/ANDROID 289 /variable/APPLE 290 /variable/BORLAND 291 /variable/CMAKE_ANDROID_NDK_VERSION 292 /variable/CMAKE_CL_64 293 /variable/CMAKE_COMPILER_2005 294 /variable/CMAKE_HOST_APPLE 295 /variable/CMAKE_HOST_SOLARIS 296 /variable/CMAKE_HOST_SYSTEM 297 /variable/CMAKE_HOST_SYSTEM_NAME 298 /variable/CMAKE_HOST_SYSTEM_PROCESSOR 299 /variable/CMAKE_HOST_SYSTEM_VERSION 300 /variable/CMAKE_HOST_UNIX 301 /variable/CMAKE_HOST_WIN32 302 /variable/CMAKE_LIBRARY_ARCHITECTURE 303 /variable/CMAKE_LIBRARY_ARCHITECTURE_REGEX 304 /variable/CMAKE_OBJECT_PATH_MAX 305 /variable/CMAKE_SYSTEM 306 /variable/CMAKE_SYSTEM_NAME 307 /variable/CMAKE_SYSTEM_PROCESSOR 308 /variable/CMAKE_SYSTEM_VERSION 309 /variable/CYGWIN 310 /variable/GHS-MULTI 311 /variable/IOS 312 /variable/MINGW 313 /variable/MSVC 314 /variable/MSVC10 315 /variable/MSVC11 316 /variable/MSVC12 317 /variable/MSVC14 318 /variable/MSVC60 319 /variable/MSVC70 320 /variable/MSVC71 321 /variable/MSVC80 322 /variable/MSVC90 323 /variable/MSVC_IDE 324 /variable/MSVC_TOOLSET_VERSION 325 /variable/MSVC_VERSION 326 /variable/MSYS 327 /variable/UNIX 328 /variable/WIN32 329 /variable/WINCE 330 /variable/WINDOWS_PHONE 331 /variable/WINDOWS_STORE 332 /variable/XCODE 333 /variable/XCODE_VERSION 334 335Variables that Control the Build 336================================ 337 338.. toctree:: 339 :maxdepth: 1 340 341 /variable/CMAKE_AIX_EXPORT_ALL_SYMBOLS 342 /variable/CMAKE_ANDROID_ANT_ADDITIONAL_OPTIONS 343 /variable/CMAKE_ANDROID_API 344 /variable/CMAKE_ANDROID_API_MIN 345 /variable/CMAKE_ANDROID_ARCH 346 /variable/CMAKE_ANDROID_ARCH_ABI 347 /variable/CMAKE_ANDROID_ARM_MODE 348 /variable/CMAKE_ANDROID_ARM_NEON 349 /variable/CMAKE_ANDROID_ASSETS_DIRECTORIES 350 /variable/CMAKE_ANDROID_EXCEPTIONS 351 /variable/CMAKE_ANDROID_GUI 352 /variable/CMAKE_ANDROID_JAR_DEPENDENCIES 353 /variable/CMAKE_ANDROID_JAR_DIRECTORIES 354 /variable/CMAKE_ANDROID_JAVA_SOURCE_DIR 355 /variable/CMAKE_ANDROID_NATIVE_LIB_DEPENDENCIES 356 /variable/CMAKE_ANDROID_NATIVE_LIB_DIRECTORIES 357 /variable/CMAKE_ANDROID_NDK 358 /variable/CMAKE_ANDROID_NDK_DEPRECATED_HEADERS 359 /variable/CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG 360 /variable/CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION 361 /variable/CMAKE_ANDROID_PROCESS_MAX 362 /variable/CMAKE_ANDROID_PROGUARD 363 /variable/CMAKE_ANDROID_PROGUARD_CONFIG_PATH 364 /variable/CMAKE_ANDROID_RTTI 365 /variable/CMAKE_ANDROID_SECURE_PROPS_PATH 366 /variable/CMAKE_ANDROID_SKIP_ANT_STEP 367 /variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN 368 /variable/CMAKE_ANDROID_STL_TYPE 369 /variable/CMAKE_APPLE_SILICON_PROCESSOR 370 /variable/CMAKE_ARCHIVE_OUTPUT_DIRECTORY 371 /variable/CMAKE_ARCHIVE_OUTPUT_DIRECTORY_CONFIG 372 /variable/CMAKE_AUTOGEN_ORIGIN_DEPENDS 373 /variable/CMAKE_AUTOGEN_PARALLEL 374 /variable/CMAKE_AUTOGEN_VERBOSE 375 /variable/CMAKE_AUTOMOC 376 /variable/CMAKE_AUTOMOC_COMPILER_PREDEFINES 377 /variable/CMAKE_AUTOMOC_DEPEND_FILTERS 378 /variable/CMAKE_AUTOMOC_MACRO_NAMES 379 /variable/CMAKE_AUTOMOC_MOC_OPTIONS 380 /variable/CMAKE_AUTOMOC_PATH_PREFIX 381 /variable/CMAKE_AUTORCC 382 /variable/CMAKE_AUTORCC_OPTIONS 383 /variable/CMAKE_AUTOUIC 384 /variable/CMAKE_AUTOUIC_OPTIONS 385 /variable/CMAKE_AUTOUIC_SEARCH_PATHS 386 /variable/CMAKE_BUILD_RPATH 387 /variable/CMAKE_BUILD_RPATH_USE_ORIGIN 388 /variable/CMAKE_BUILD_WITH_INSTALL_NAME_DIR 389 /variable/CMAKE_BUILD_WITH_INSTALL_RPATH 390 /variable/CMAKE_COMPILE_PDB_OUTPUT_DIRECTORY 391 /variable/CMAKE_COMPILE_PDB_OUTPUT_DIRECTORY_CONFIG 392 /variable/CMAKE_CONFIG_POSTFIX 393 /variable/CMAKE_CROSS_CONFIGS 394 /variable/CMAKE_CTEST_ARGUMENTS 395 /variable/CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS 396 /variable/CMAKE_CUDA_RUNTIME_LIBRARY 397 /variable/CMAKE_CUDA_SEPARABLE_COMPILATION 398 /variable/CMAKE_DEBUG_POSTFIX 399 /variable/CMAKE_DEFAULT_BUILD_TYPE 400 /variable/CMAKE_DEFAULT_CONFIGS 401 /variable/CMAKE_DISABLE_PRECOMPILE_HEADERS 402 /variable/CMAKE_DEPENDS_USE_COMPILER 403 /variable/CMAKE_ENABLE_EXPORTS 404 /variable/CMAKE_EXE_LINKER_FLAGS 405 /variable/CMAKE_EXE_LINKER_FLAGS_CONFIG 406 /variable/CMAKE_EXE_LINKER_FLAGS_CONFIG_INIT 407 /variable/CMAKE_EXE_LINKER_FLAGS_INIT 408 /variable/CMAKE_FOLDER 409 /variable/CMAKE_FRAMEWORK 410 /variable/CMAKE_FRAMEWORK_MULTI_CONFIG_POSTFIX_CONFIG 411 /variable/CMAKE_Fortran_FORMAT 412 /variable/CMAKE_Fortran_MODULE_DIRECTORY 413 /variable/CMAKE_Fortran_PREPROCESS 414 /variable/CMAKE_GHS_NO_SOURCE_GROUP_FILE 415 /variable/CMAKE_GLOBAL_AUTOGEN_TARGET 416 /variable/CMAKE_GLOBAL_AUTOGEN_TARGET_NAME 417 /variable/CMAKE_GLOBAL_AUTORCC_TARGET 418 /variable/CMAKE_GLOBAL_AUTORCC_TARGET_NAME 419 /variable/CMAKE_GNUtoMS 420 /variable/CMAKE_INCLUDE_CURRENT_DIR 421 /variable/CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE 422 /variable/CMAKE_INSTALL_NAME_DIR 423 /variable/CMAKE_INSTALL_REMOVE_ENVIRONMENT_RPATH 424 /variable/CMAKE_INSTALL_RPATH 425 /variable/CMAKE_INSTALL_RPATH_USE_LINK_PATH 426 /variable/CMAKE_INTERPROCEDURAL_OPTIMIZATION 427 /variable/CMAKE_INTERPROCEDURAL_OPTIMIZATION_CONFIG 428 /variable/CMAKE_IOS_INSTALL_COMBINED 429 /variable/CMAKE_LANG_CLANG_TIDY 430 /variable/CMAKE_LANG_COMPILER_LAUNCHER 431 /variable/CMAKE_LANG_CPPCHECK 432 /variable/CMAKE_LANG_CPPLINT 433 /variable/CMAKE_LANG_INCLUDE_WHAT_YOU_USE 434 /variable/CMAKE_LANG_LINKER_LAUNCHER 435 /variable/CMAKE_LANG_LINK_LIBRARY_FILE_FLAG 436 /variable/CMAKE_LANG_LINK_LIBRARY_FLAG 437 /variable/CMAKE_LANG_LINK_WHAT_YOU_USE_FLAG 438 /variable/CMAKE_LANG_VISIBILITY_PRESET 439 /variable/CMAKE_LIBRARY_OUTPUT_DIRECTORY 440 /variable/CMAKE_LIBRARY_OUTPUT_DIRECTORY_CONFIG 441 /variable/CMAKE_LIBRARY_PATH_FLAG 442 /variable/CMAKE_LINK_DEF_FILE_FLAG 443 /variable/CMAKE_LINK_DEPENDS_NO_SHARED 444 /variable/CMAKE_LINK_INTERFACE_LIBRARIES 445 /variable/CMAKE_LINK_LIBRARY_FILE_FLAG 446 /variable/CMAKE_LINK_LIBRARY_FLAG 447 /variable/CMAKE_LINK_WHAT_YOU_USE 448 /variable/CMAKE_LINK_WHAT_YOU_USE_CHECK 449 /variable/CMAKE_MACOSX_BUNDLE 450 /variable/CMAKE_MACOSX_RPATH 451 /variable/CMAKE_MAP_IMPORTED_CONFIG_CONFIG 452 /variable/CMAKE_MODULE_LINKER_FLAGS 453 /variable/CMAKE_MODULE_LINKER_FLAGS_CONFIG 454 /variable/CMAKE_MODULE_LINKER_FLAGS_CONFIG_INIT 455 /variable/CMAKE_MODULE_LINKER_FLAGS_INIT 456 /variable/CMAKE_MSVCIDE_RUN_PATH 457 /variable/CMAKE_MSVC_RUNTIME_LIBRARY 458 /variable/CMAKE_NINJA_OUTPUT_PATH_PREFIX 459 /variable/CMAKE_NO_BUILTIN_CHRPATH 460 /variable/CMAKE_NO_SYSTEM_FROM_IMPORTED 461 /variable/CMAKE_OPTIMIZE_DEPENDENCIES 462 /variable/CMAKE_OSX_ARCHITECTURES 463 /variable/CMAKE_OSX_DEPLOYMENT_TARGET 464 /variable/CMAKE_OSX_SYSROOT 465 /variable/CMAKE_PCH_WARN_INVALID 466 /variable/CMAKE_PCH_INSTANTIATE_TEMPLATES 467 /variable/CMAKE_PDB_OUTPUT_DIRECTORY 468 /variable/CMAKE_PDB_OUTPUT_DIRECTORY_CONFIG 469 /variable/CMAKE_POSITION_INDEPENDENT_CODE 470 /variable/CMAKE_RUNTIME_OUTPUT_DIRECTORY 471 /variable/CMAKE_RUNTIME_OUTPUT_DIRECTORY_CONFIG 472 /variable/CMAKE_SHARED_LINKER_FLAGS 473 /variable/CMAKE_SHARED_LINKER_FLAGS_CONFIG 474 /variable/CMAKE_SHARED_LINKER_FLAGS_CONFIG_INIT 475 /variable/CMAKE_SHARED_LINKER_FLAGS_INIT 476 /variable/CMAKE_SKIP_BUILD_RPATH 477 /variable/CMAKE_SKIP_INSTALL_RPATH 478 /variable/CMAKE_STATIC_LINKER_FLAGS 479 /variable/CMAKE_STATIC_LINKER_FLAGS_CONFIG 480 /variable/CMAKE_STATIC_LINKER_FLAGS_CONFIG_INIT 481 /variable/CMAKE_STATIC_LINKER_FLAGS_INIT 482 /variable/CMAKE_TRY_COMPILE_CONFIGURATION 483 /variable/CMAKE_TRY_COMPILE_PLATFORM_VARIABLES 484 /variable/CMAKE_TRY_COMPILE_TARGET_TYPE 485 /variable/CMAKE_UNITY_BUILD 486 /variable/CMAKE_UNITY_BUILD_BATCH_SIZE 487 /variable/CMAKE_UNITY_BUILD_UNIQUE_ID 488 /variable/CMAKE_USE_RELATIVE_PATHS 489 /variable/CMAKE_VISIBILITY_INLINES_HIDDEN 490 /variable/CMAKE_VS_GLOBALS 491 /variable/CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 492 /variable/CMAKE_VS_INCLUDE_PACKAGE_TO_DEFAULT_BUILD 493 /variable/CMAKE_VS_JUST_MY_CODE_DEBUGGING 494 /variable/CMAKE_VS_SDK_EXCLUDE_DIRECTORIES 495 /variable/CMAKE_VS_SDK_EXECUTABLE_DIRECTORIES 496 /variable/CMAKE_VS_SDK_INCLUDE_DIRECTORIES 497 /variable/CMAKE_VS_SDK_LIBRARY_DIRECTORIES 498 /variable/CMAKE_VS_SDK_LIBRARY_WINRT_DIRECTORIES 499 /variable/CMAKE_VS_SDK_REFERENCE_DIRECTORIES 500 /variable/CMAKE_VS_SDK_SOURCE_DIRECTORIES 501 /variable/CMAKE_VS_WINRT_BY_DEFAULT 502 /variable/CMAKE_WIN32_EXECUTABLE 503 /variable/CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS 504 /variable/CMAKE_XCODE_ATTRIBUTE_an-attribute 505 /variable/EXECUTABLE_OUTPUT_PATH 506 /variable/LIBRARY_OUTPUT_PATH 507 508Variables for Languages 509======================= 510 511.. toctree:: 512 :maxdepth: 1 513 514 /variable/CMAKE_COMPILER_IS_GNUCC 515 /variable/CMAKE_COMPILER_IS_GNUCXX 516 /variable/CMAKE_COMPILER_IS_GNUG77 517 /variable/CMAKE_CUDA_ARCHITECTURES 518 /variable/CMAKE_CUDA_COMPILE_FEATURES 519 /variable/CMAKE_CUDA_EXTENSIONS 520 /variable/CMAKE_CUDA_HOST_COMPILER 521 /variable/CMAKE_CUDA_STANDARD 522 /variable/CMAKE_CUDA_STANDARD_REQUIRED 523 /variable/CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES 524 /variable/CMAKE_CXX_COMPILE_FEATURES 525 /variable/CMAKE_CXX_EXTENSIONS 526 /variable/CMAKE_CXX_STANDARD 527 /variable/CMAKE_CXX_STANDARD_REQUIRED 528 /variable/CMAKE_C_COMPILE_FEATURES 529 /variable/CMAKE_C_EXTENSIONS 530 /variable/CMAKE_C_STANDARD 531 /variable/CMAKE_C_STANDARD_REQUIRED 532 /variable/CMAKE_Fortran_MODDIR_DEFAULT 533 /variable/CMAKE_Fortran_MODDIR_FLAG 534 /variable/CMAKE_Fortran_MODOUT_FLAG 535 /variable/CMAKE_HIP_ARCHITECTURES 536 /variable/CMAKE_HIP_EXTENSIONS 537 /variable/CMAKE_HIP_STANDARD 538 /variable/CMAKE_HIP_STANDARD_REQUIRED 539 /variable/CMAKE_ISPC_HEADER_DIRECTORY 540 /variable/CMAKE_ISPC_HEADER_SUFFIX 541 /variable/CMAKE_ISPC_INSTRUCTION_SETS 542 /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_MACHINE 543 /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_PREFIX 544 /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX 545 /variable/CMAKE_LANG_ARCHIVE_APPEND 546 /variable/CMAKE_LANG_ARCHIVE_CREATE 547 /variable/CMAKE_LANG_ARCHIVE_FINISH 548 /variable/CMAKE_LANG_BYTE_ORDER 549 /variable/CMAKE_LANG_COMPILER 550 /variable/CMAKE_LANG_COMPILER_EXTERNAL_TOOLCHAIN 551 /variable/CMAKE_LANG_COMPILER_ID 552 /variable/CMAKE_LANG_COMPILER_LOADED 553 /variable/CMAKE_LANG_COMPILER_PREDEFINES_COMMAND 554 /variable/CMAKE_LANG_COMPILER_TARGET 555 /variable/CMAKE_LANG_COMPILER_VERSION 556 /variable/CMAKE_LANG_COMPILE_OBJECT 557 /variable/CMAKE_LANG_CREATE_SHARED_LIBRARY 558 /variable/CMAKE_LANG_CREATE_SHARED_MODULE 559 /variable/CMAKE_LANG_CREATE_STATIC_LIBRARY 560 /variable/CMAKE_LANG_EXTENSIONS 561 /variable/CMAKE_LANG_EXTENSIONS_DEFAULT 562 /variable/CMAKE_LANG_FLAGS 563 /variable/CMAKE_LANG_FLAGS_CONFIG 564 /variable/CMAKE_LANG_FLAGS_CONFIG_INIT 565 /variable/CMAKE_LANG_FLAGS_DEBUG 566 /variable/CMAKE_LANG_FLAGS_DEBUG_INIT 567 /variable/CMAKE_LANG_FLAGS_INIT 568 /variable/CMAKE_LANG_FLAGS_MINSIZEREL 569 /variable/CMAKE_LANG_FLAGS_MINSIZEREL_INIT 570 /variable/CMAKE_LANG_FLAGS_RELEASE 571 /variable/CMAKE_LANG_FLAGS_RELEASE_INIT 572 /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO 573 /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO_INIT 574 /variable/CMAKE_LANG_IGNORE_EXTENSIONS 575 /variable/CMAKE_LANG_IMPLICIT_INCLUDE_DIRECTORIES 576 /variable/CMAKE_LANG_IMPLICIT_LINK_DIRECTORIES 577 /variable/CMAKE_LANG_IMPLICIT_LINK_FRAMEWORK_DIRECTORIES 578 /variable/CMAKE_LANG_IMPLICIT_LINK_LIBRARIES 579 /variable/CMAKE_LANG_LIBRARY_ARCHITECTURE 580 /variable/CMAKE_LANG_LINK_EXECUTABLE 581 /variable/CMAKE_LANG_LINKER_PREFERENCE 582 /variable/CMAKE_LANG_LINKER_PREFERENCE_PROPAGATES 583 /variable/CMAKE_LANG_LINKER_WRAPPER_FLAG 584 /variable/CMAKE_LANG_LINKER_WRAPPER_FLAG_SEP 585 /variable/CMAKE_LANG_OUTPUT_EXTENSION 586 /variable/CMAKE_LANG_SIMULATE_ID 587 /variable/CMAKE_LANG_SIMULATE_VERSION 588 /variable/CMAKE_LANG_SIZEOF_DATA_PTR 589 /variable/CMAKE_LANG_SOURCE_FILE_EXTENSIONS 590 /variable/CMAKE_LANG_STANDARD 591 /variable/CMAKE_LANG_STANDARD_DEFAULT 592 /variable/CMAKE_LANG_STANDARD_INCLUDE_DIRECTORIES 593 /variable/CMAKE_LANG_STANDARD_LIBRARIES 594 /variable/CMAKE_LANG_STANDARD_REQUIRED 595 /variable/CMAKE_OBJC_EXTENSIONS 596 /variable/CMAKE_OBJC_STANDARD 597 /variable/CMAKE_OBJC_STANDARD_REQUIRED 598 /variable/CMAKE_OBJCXX_EXTENSIONS 599 /variable/CMAKE_OBJCXX_STANDARD 600 /variable/CMAKE_OBJCXX_STANDARD_REQUIRED 601 /variable/CMAKE_Swift_LANGUAGE_VERSION 602 /variable/CMAKE_USER_MAKE_RULES_OVERRIDE_LANG 603 604Variables for CTest 605=================== 606 607.. toctree:: 608 :maxdepth: 1 609 610 /variable/CTEST_BINARY_DIRECTORY 611 /variable/CTEST_BUILD_COMMAND 612 /variable/CTEST_BUILD_NAME 613 /variable/CTEST_BZR_COMMAND 614 /variable/CTEST_BZR_UPDATE_OPTIONS 615 /variable/CTEST_CHANGE_ID 616 /variable/CTEST_CHECKOUT_COMMAND 617 /variable/CTEST_CONFIGURATION_TYPE 618 /variable/CTEST_CONFIGURE_COMMAND 619 /variable/CTEST_COVERAGE_COMMAND 620 /variable/CTEST_COVERAGE_EXTRA_FLAGS 621 /variable/CTEST_CURL_OPTIONS 622 /variable/CTEST_CUSTOM_COVERAGE_EXCLUDE 623 /variable/CTEST_CUSTOM_ERROR_EXCEPTION 624 /variable/CTEST_CUSTOM_ERROR_MATCH 625 /variable/CTEST_CUSTOM_ERROR_POST_CONTEXT 626 /variable/CTEST_CUSTOM_ERROR_PRE_CONTEXT 627 /variable/CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE 628 /variable/CTEST_CUSTOM_MAXIMUM_NUMBER_OF_ERRORS 629 /variable/CTEST_CUSTOM_MAXIMUM_NUMBER_OF_WARNINGS 630 /variable/CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE 631 /variable/CTEST_CUSTOM_MEMCHECK_IGNORE 632 /variable/CTEST_CUSTOM_POST_MEMCHECK 633 /variable/CTEST_CUSTOM_POST_TEST 634 /variable/CTEST_CUSTOM_PRE_MEMCHECK 635 /variable/CTEST_CUSTOM_PRE_TEST 636 /variable/CTEST_CUSTOM_TESTS_IGNORE 637 /variable/CTEST_CUSTOM_WARNING_EXCEPTION 638 /variable/CTEST_CUSTOM_WARNING_MATCH 639 /variable/CTEST_CVS_CHECKOUT 640 /variable/CTEST_CVS_COMMAND 641 /variable/CTEST_CVS_UPDATE_OPTIONS 642 /variable/CTEST_DROP_LOCATION 643 /variable/CTEST_DROP_METHOD 644 /variable/CTEST_DROP_SITE 645 /variable/CTEST_DROP_SITE_CDASH 646 /variable/CTEST_DROP_SITE_PASSWORD 647 /variable/CTEST_DROP_SITE_USER 648 /variable/CTEST_EXTRA_COVERAGE_GLOB 649 /variable/CTEST_GIT_COMMAND 650 /variable/CTEST_GIT_INIT_SUBMODULES 651 /variable/CTEST_GIT_UPDATE_CUSTOM 652 /variable/CTEST_GIT_UPDATE_OPTIONS 653 /variable/CTEST_HG_COMMAND 654 /variable/CTEST_HG_UPDATE_OPTIONS 655 /variable/CTEST_LABELS_FOR_SUBPROJECTS 656 /variable/CTEST_MEMORYCHECK_COMMAND 657 /variable/CTEST_MEMORYCHECK_COMMAND_OPTIONS 658 /variable/CTEST_MEMORYCHECK_SANITIZER_OPTIONS 659 /variable/CTEST_MEMORYCHECK_SUPPRESSIONS_FILE 660 /variable/CTEST_MEMORYCHECK_TYPE 661 /variable/CTEST_NIGHTLY_START_TIME 662 /variable/CTEST_P4_CLIENT 663 /variable/CTEST_P4_COMMAND 664 /variable/CTEST_P4_OPTIONS 665 /variable/CTEST_P4_UPDATE_OPTIONS 666 /variable/CTEST_RESOURCE_SPEC_FILE 667 /variable/CTEST_RUN_CURRENT_SCRIPT 668 /variable/CTEST_SCP_COMMAND 669 /variable/CTEST_SCRIPT_DIRECTORY 670 /variable/CTEST_SITE 671 /variable/CTEST_SUBMIT_URL 672 /variable/CTEST_SOURCE_DIRECTORY 673 /variable/CTEST_SVN_COMMAND 674 /variable/CTEST_SVN_OPTIONS 675 /variable/CTEST_SVN_UPDATE_OPTIONS 676 /variable/CTEST_TEST_LOAD 677 /variable/CTEST_TEST_TIMEOUT 678 /variable/CTEST_TRIGGER_SITE 679 /variable/CTEST_UPDATE_COMMAND 680 /variable/CTEST_UPDATE_OPTIONS 681 /variable/CTEST_UPDATE_VERSION_ONLY 682 /variable/CTEST_UPDATE_VERSION_OVERRIDE 683 /variable/CTEST_USE_LAUNCHERS 684 685Variables for CPack 686=================== 687 688.. toctree:: 689 :maxdepth: 1 690 691 /variable/CPACK_ABSOLUTE_DESTINATION_FILES 692 /variable/CPACK_COMPONENT_INCLUDE_TOPLEVEL_DIRECTORY 693 /variable/CPACK_CUSTOM_INSTALL_VARIABLES 694 /variable/CPACK_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION 695 /variable/CPACK_INCLUDE_TOPLEVEL_DIRECTORY 696 /variable/CPACK_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS 697 /variable/CPACK_PACKAGING_INSTALL_PREFIX 698 /variable/CPACK_SET_DESTDIR 699 /variable/CPACK_WARN_ON_ABSOLUTE_INSTALL_DESTINATION 700 701Variable Expansion Operators 702============================ 703 704.. toctree:: 705 :maxdepth: 1 706 707 /variable/CACHE 708 /variable/ENV 709 710Internal Variables 711================== 712 713CMake has many internal variables. Most of them are undocumented. 714Some of them, however, were at some point described as normal 715variables, and therefore may be encountered in legacy code. They 716are subject to change, and not recommended for use in project code. 717 718.. toctree:: 719 :maxdepth: 1 720 721 /variable/CMAKE_HOME_DIRECTORY 722 /variable/CMAKE_INTERNAL_PLATFORM_ABI 723 /variable/CMAKE_LANG_COMPILER_ABI 724 /variable/CMAKE_LANG_COMPILER_ARCHITECTURE_ID 725 /variable/CMAKE_LANG_COMPILER_VERSION_INTERNAL 726 /variable/CMAKE_LANG_PLATFORM_ID 727 /variable/CMAKE_NOT_USING_CONFIG_FLAGS 728 /variable/CMAKE_VS_INTEL_Fortran_PROJECT_VERSION 729