cmake-variables.7.rst 22.1 KB
Newer Older
1 2
.. cmake-manual-description: CMake Variables Reference

3 4 5
cmake-variables(7)
******************

Brad King's avatar
Brad King committed
6
.. only:: html
7 8 9

   .. contents::

Joachim Wuttke's avatar
Joachim Wuttke committed
10 11 12 13 14 15 16 17
This page  documents variables that are provided by CMake
or have meaning to CMake when set by project code.

For general information on variables, see the
:ref:`Variables <CMake Language Variables>`
section in the cmake-language manual.


18 19 20 21
Variables that Provide Information
==================================

.. toctree::
22 23
   :maxdepth: 1

24
   /variable/CMAKE_AR
25 26 27 28 29 30 31 32 33 34
   /variable/CMAKE_ARGC
   /variable/CMAKE_ARGV0
   /variable/CMAKE_BINARY_DIR
   /variable/CMAKE_BUILD_TOOL
   /variable/CMAKE_CACHEFILE_DIR
   /variable/CMAKE_CACHE_MAJOR_VERSION
   /variable/CMAKE_CACHE_MINOR_VERSION
   /variable/CMAKE_CACHE_PATCH_VERSION
   /variable/CMAKE_CFG_INTDIR
   /variable/CMAKE_COMMAND
35
   /variable/CMAKE_CPACK_COMMAND
36
   /variable/CMAKE_CROSSCOMPILING
37
   /variable/CMAKE_CROSSCOMPILING_EMULATOR
38 39 40 41 42 43
   /variable/CMAKE_CTEST_COMMAND
   /variable/CMAKE_CURRENT_BINARY_DIR
   /variable/CMAKE_CURRENT_LIST_DIR
   /variable/CMAKE_CURRENT_LIST_FILE
   /variable/CMAKE_CURRENT_LIST_LINE
   /variable/CMAKE_CURRENT_SOURCE_DIR
44
   /variable/CMAKE_DIRECTORY_LABELS
45
   /variable/CMAKE_DL_LIBS
46
   /variable/CMAKE_DOTNET_TARGET_FRAMEWORK_VERSION
47 48 49 50
   /variable/CMAKE_EDIT_COMMAND
   /variable/CMAKE_EXECUTABLE_SUFFIX
   /variable/CMAKE_EXTRA_GENERATOR
   /variable/CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES
51
   /variable/CMAKE_FIND_PACKAGE_NAME
52 53
   /variable/CMAKE_FIND_PACKAGE_SORT_DIRECTION
   /variable/CMAKE_FIND_PACKAGE_SORT_ORDER
54
   /variable/CMAKE_GENERATOR
55
   /variable/CMAKE_GENERATOR_INSTANCE
56
   /variable/CMAKE_GENERATOR_PLATFORM
57 58 59
   /variable/CMAKE_GENERATOR_TOOLSET
   /variable/CMAKE_IMPORT_LIBRARY_PREFIX
   /variable/CMAKE_IMPORT_LIBRARY_SUFFIX
60 61
   /variable/CMAKE_JOB_POOL_COMPILE
   /variable/CMAKE_JOB_POOL_LINK
62
   /variable/CMAKE_JOB_POOLS
63 64
   /variable/CMAKE_LANG_COMPILER_AR
   /variable/CMAKE_LANG_COMPILER_RANLIB
65
   /variable/CMAKE_LINK_LIBRARY_SUFFIX
66 67
   /variable/CMAKE_LINK_SEARCH_END_STATIC
   /variable/CMAKE_LINK_SEARCH_START_STATIC
68 69
   /variable/CMAKE_MAJOR_VERSION
   /variable/CMAKE_MAKE_PROGRAM
70
   /variable/CMAKE_MATCH_COUNT
71
   /variable/CMAKE_MATCH_n
72 73
   /variable/CMAKE_MINIMUM_REQUIRED_VERSION
   /variable/CMAKE_MINOR_VERSION
74 75
   /variable/CMAKE_NETRC
   /variable/CMAKE_NETRC_FILE
76 77
   /variable/CMAKE_PARENT_LIST_FILE
   /variable/CMAKE_PATCH_VERSION
78
   /variable/CMAKE_PROJECT_DESCRIPTION
79
   /variable/CMAKE_PROJECT_HOMEPAGE_URL
80
   /variable/CMAKE_PROJECT_NAME
81 82 83 84 85
   /variable/CMAKE_PROJECT_VERSION
   /variable/CMAKE_PROJECT_VERSION_MAJOR
   /variable/CMAKE_PROJECT_VERSION_MINOR
   /variable/CMAKE_PROJECT_VERSION_PATCH
   /variable/CMAKE_PROJECT_VERSION_TWEAK
86 87
   /variable/CMAKE_RANLIB
   /variable/CMAKE_ROOT
88
   /variable/CMAKE_RULE_MESSAGES
89 90 91 92 93 94
   /variable/CMAKE_SCRIPT_MODE_FILE
   /variable/CMAKE_SHARED_LIBRARY_PREFIX
   /variable/CMAKE_SHARED_LIBRARY_SUFFIX
   /variable/CMAKE_SHARED_MODULE_PREFIX
   /variable/CMAKE_SHARED_MODULE_SUFFIX
   /variable/CMAKE_SIZEOF_VOID_P
95
   /variable/CMAKE_SKIP_INSTALL_RULES
96 97 98 99
   /variable/CMAKE_SKIP_RPATH
   /variable/CMAKE_SOURCE_DIR
   /variable/CMAKE_STATIC_LIBRARY_PREFIX
   /variable/CMAKE_STATIC_LIBRARY_SUFFIX
100
   /variable/CMAKE_TOOLCHAIN_FILE
101 102 103
   /variable/CMAKE_TWEAK_VERSION
   /variable/CMAKE_VERBOSE_MAKEFILE
   /variable/CMAKE_VERSION
104 105
   /variable/CMAKE_VS_DEVENV_COMMAND
   /variable/CMAKE_VS_MSBUILD_COMMAND
106
   /variable/CMAKE_VS_NsightTegra_VERSION
107
   /variable/CMAKE_VS_PLATFORM_NAME
108
   /variable/CMAKE_VS_PLATFORM_TOOLSET
109
   /variable/CMAKE_VS_PLATFORM_TOOLSET_CUDA
110
   /variable/CMAKE_VS_PLATFORM_TOOLSET_HOST_ARCHITECTURE
111
   /variable/CMAKE_VS_PLATFORM_TOOLSET_VERSION
112
   /variable/CMAKE_VS_WINDOWS_TARGET_PLATFORM_VERSION
113
   /variable/CMAKE_XCODE_GENERATE_SCHEME
114 115
   /variable/CMAKE_XCODE_PLATFORM_TOOLSET
   /variable/PROJECT-NAME_BINARY_DIR
116
   /variable/PROJECT-NAME_DESCRIPTION
117
   /variable/PROJECT-NAME_HOMEPAGE_URL
118
   /variable/PROJECT-NAME_SOURCE_DIR
Brad King's avatar
Brad King committed
119 120 121 122 123
   /variable/PROJECT-NAME_VERSION
   /variable/PROJECT-NAME_VERSION_MAJOR
   /variable/PROJECT-NAME_VERSION_MINOR
   /variable/PROJECT-NAME_VERSION_PATCH
   /variable/PROJECT-NAME_VERSION_TWEAK
124
   /variable/PROJECT_BINARY_DIR
125
   /variable/PROJECT_DESCRIPTION
126
   /variable/PROJECT_HOMEPAGE_URL
127
   /variable/PROJECT_NAME
128
   /variable/PROJECT_SOURCE_DIR
Brad King's avatar
Brad King committed
129 130 131 132 133
   /variable/PROJECT_VERSION
   /variable/PROJECT_VERSION_MAJOR
   /variable/PROJECT_VERSION_MINOR
   /variable/PROJECT_VERSION_PATCH
   /variable/PROJECT_VERSION_TWEAK
134 135 136 137 138

Variables that Change Behavior
==============================

.. toctree::
139 140
   :maxdepth: 1

141 142
   /variable/BUILD_SHARED_LIBS
   /variable/CMAKE_ABSOLUTE_DESTINATION_FILES
143
   /variable/CMAKE_APPBUNDLE_PATH
144 145 146
   /variable/CMAKE_AUTOMOC_RELAXED_MODE
   /variable/CMAKE_BACKWARDS_COMPATIBILITY
   /variable/CMAKE_BUILD_TYPE
147
   /variable/CMAKE_CODEBLOCKS_COMPILER_ID
148
   /variable/CMAKE_CODEBLOCKS_EXCLUDE_EXTERNAL_FILES
149
   /variable/CMAKE_CODELITE_USE_TARGETS
150 151 152
   /variable/CMAKE_COLOR_MAKEFILE
   /variable/CMAKE_CONFIGURATION_TYPES
   /variable/CMAKE_DEBUG_TARGET_PROPERTIES
153
   /variable/CMAKE_DEPENDS_IN_PROJECT_ONLY
154
   /variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName
155 156 157 158
   /variable/CMAKE_ECLIPSE_GENERATE_LINKED_RESOURCES
   /variable/CMAKE_ECLIPSE_GENERATE_SOURCE_PROJECT
   /variable/CMAKE_ECLIPSE_MAKE_ARGUMENTS
   /variable/CMAKE_ECLIPSE_VERSION
159 160
   /variable/CMAKE_ERROR_DEPRECATED
   /variable/CMAKE_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION
161
   /variable/CMAKE_EXPORT_COMPILE_COMMANDS
162
   /variable/CMAKE_EXPORT_PACKAGE_REGISTRY
163
   /variable/CMAKE_EXPORT_NO_PACKAGE_REGISTRY
164 165
   /variable/CMAKE_FIND_APPBUNDLE
   /variable/CMAKE_FIND_FRAMEWORK
166
   /variable/CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX
167 168
   /variable/CMAKE_FIND_LIBRARY_PREFIXES
   /variable/CMAKE_FIND_LIBRARY_SUFFIXES
169
   /variable/CMAKE_FIND_NO_INSTALL_PREFIX
170 171
   /variable/CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
   /variable/CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY
172
   /variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS
173 174 175 176 177 178
   /variable/CMAKE_FIND_PACKAGE_WARN_NO_MODULE
   /variable/CMAKE_FIND_ROOT_PATH
   /variable/CMAKE_FIND_ROOT_PATH_MODE_INCLUDE
   /variable/CMAKE_FIND_ROOT_PATH_MODE_LIBRARY
   /variable/CMAKE_FIND_ROOT_PATH_MODE_PACKAGE
   /variable/CMAKE_FIND_ROOT_PATH_MODE_PROGRAM
179
   /variable/CMAKE_FRAMEWORK_PATH
180
   /variable/CMAKE_IGNORE_PATH
181 182
   /variable/CMAKE_INCLUDE_DIRECTORIES_BEFORE
   /variable/CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE
183
   /variable/CMAKE_INCLUDE_PATH
184
   /variable/CMAKE_INSTALL_DEFAULT_COMPONENT_NAME
185
   /variable/CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS
186
   /variable/CMAKE_INSTALL_MESSAGE
187
   /variable/CMAKE_INSTALL_PREFIX
188
   /variable/CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT
189
   /variable/CMAKE_LIBRARY_PATH
190
   /variable/CMAKE_LINK_DIRECTORIES_BEFORE
191
   /variable/CMAKE_MFC_FLAG
192
   /variable/CMAKE_MAXIMUM_RECURSION_DEPTH
193 194
   /variable/CMAKE_MODULE_PATH
   /variable/CMAKE_POLICY_DEFAULT_CMPNNNN
195
   /variable/CMAKE_POLICY_WARNING_CMPNNNN
196 197
   /variable/CMAKE_PREFIX_PATH
   /variable/CMAKE_PROGRAM_PATH
198
   /variable/CMAKE_PROJECT_INCLUDE
199
   /variable/CMAKE_PROJECT_INCLUDE_BEFORE
200
   /variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE
201
   /variable/CMAKE_SKIP_INSTALL_ALL_DEPENDENCY
202
   /variable/CMAKE_STAGING_PREFIX
203
   /variable/CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS
204
   /variable/CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE
205
   /variable/CMAKE_SUPPRESS_REGENERATION
206
   /variable/CMAKE_SYSROOT
207 208
   /variable/CMAKE_SYSROOT_COMPILE
   /variable/CMAKE_SYSROOT_LINK
209
   /variable/CMAKE_SYSTEM_APPBUNDLE_PATH
210
   /variable/CMAKE_SYSTEM_FRAMEWORK_PATH
211 212 213 214 215 216 217 218
   /variable/CMAKE_SYSTEM_IGNORE_PATH
   /variable/CMAKE_SYSTEM_INCLUDE_PATH
   /variable/CMAKE_SYSTEM_LIBRARY_PATH
   /variable/CMAKE_SYSTEM_PREFIX_PATH
   /variable/CMAKE_SYSTEM_PROGRAM_PATH
   /variable/CMAKE_USER_MAKE_RULES_OVERRIDE
   /variable/CMAKE_WARN_DEPRECATED
   /variable/CMAKE_WARN_ON_ABSOLUTE_INSTALL_DESTINATION
219
   /variable/CMAKE_XCODE_GENERATE_TOP_LEVEL_PROJECT_ONLY
220 221
   /variable/CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER
   /variable/CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN
222 223 224 225 226 227 228 229
   /variable/CMAKE_XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER
   /variable/CMAKE_XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS
   /variable/CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE
   /variable/CMAKE_XCODE_SCHEME_GUARD_MALLOC
   /variable/CMAKE_XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP
   /variable/CMAKE_XCODE_SCHEME_MALLOC_GUARD_EDGES
   /variable/CMAKE_XCODE_SCHEME_MALLOC_SCRIBBLE
   /variable/CMAKE_XCODE_SCHEME_MALLOC_STACK
230 231 232 233 234
   /variable/CMAKE_XCODE_SCHEME_THREAD_SANITIZER
   /variable/CMAKE_XCODE_SCHEME_THREAD_SANITIZER_STOP
   /variable/CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER
   /variable/CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP
   /variable/CMAKE_XCODE_SCHEME_ZOMBIE_OBJECTS
235
   /variable/PackageName_ROOT
236 237 238 239 240

Variables that Describe the System
==================================

.. toctree::
241 242
   :maxdepth: 1

243
   /variable/ANDROID
244 245 246 247 248
   /variable/APPLE
   /variable/BORLAND
   /variable/CMAKE_CL_64
   /variable/CMAKE_COMPILER_2005
   /variable/CMAKE_HOST_APPLE
249
   /variable/CMAKE_HOST_SOLARIS
250
   /variable/CMAKE_HOST_SYSTEM
251 252 253 254 255 256
   /variable/CMAKE_HOST_SYSTEM_NAME
   /variable/CMAKE_HOST_SYSTEM_PROCESSOR
   /variable/CMAKE_HOST_SYSTEM_VERSION
   /variable/CMAKE_HOST_UNIX
   /variable/CMAKE_HOST_WIN32
   /variable/CMAKE_LIBRARY_ARCHITECTURE
257
   /variable/CMAKE_LIBRARY_ARCHITECTURE_REGEX
258
   /variable/CMAKE_OBJECT_PATH_MAX
259
   /variable/CMAKE_SYSTEM
260 261 262 263
   /variable/CMAKE_SYSTEM_NAME
   /variable/CMAKE_SYSTEM_PROCESSOR
   /variable/CMAKE_SYSTEM_VERSION
   /variable/CYGWIN
264
   /variable/GHS-MULTI
Ruslan Baratov's avatar
Ruslan Baratov committed
265
   /variable/IOS
266
   /variable/MINGW
267
   /variable/MSVC
268 269 270
   /variable/MSVC10
   /variable/MSVC11
   /variable/MSVC12
271
   /variable/MSVC14
272 273 274 275 276 277
   /variable/MSVC60
   /variable/MSVC70
   /variable/MSVC71
   /variable/MSVC80
   /variable/MSVC90
   /variable/MSVC_IDE
278
   /variable/MSVC_TOOLSET_VERSION
279
   /variable/MSVC_VERSION
280
   /variable/MSYS
281 282
   /variable/UNIX
   /variable/WIN32
283
   /variable/WINCE
284 285
   /variable/WINDOWS_PHONE
   /variable/WINDOWS_STORE
Ruslan Baratov's avatar
Ruslan Baratov committed
286
   /variable/XCODE
287 288 289 290 291 292
   /variable/XCODE_VERSION

Variables that Control the Build
================================

.. toctree::
293 294
   :maxdepth: 1

295
   /variable/CMAKE_ANDROID_ANT_ADDITIONAL_OPTIONS
296
   /variable/CMAKE_ANDROID_API
297
   /variable/CMAKE_ANDROID_API_MIN
298
   /variable/CMAKE_ANDROID_ARCH
299 300 301
   /variable/CMAKE_ANDROID_ARCH_ABI
   /variable/CMAKE_ANDROID_ARM_MODE
   /variable/CMAKE_ANDROID_ARM_NEON
302
   /variable/CMAKE_ANDROID_ASSETS_DIRECTORIES
303
   /variable/CMAKE_ANDROID_GUI
304 305 306 307 308
   /variable/CMAKE_ANDROID_JAR_DEPENDENCIES
   /variable/CMAKE_ANDROID_JAR_DIRECTORIES
   /variable/CMAKE_ANDROID_JAVA_SOURCE_DIR
   /variable/CMAKE_ANDROID_NATIVE_LIB_DEPENDENCIES
   /variable/CMAKE_ANDROID_NATIVE_LIB_DIRECTORIES
309
   /variable/CMAKE_ANDROID_NDK
310
   /variable/CMAKE_ANDROID_NDK_DEPRECATED_HEADERS
311
   /variable/CMAKE_ANDROID_NDK_TOOLCHAIN_HOST_TAG
312
   /variable/CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION
313 314 315 316 317
   /variable/CMAKE_ANDROID_PROCESS_MAX
   /variable/CMAKE_ANDROID_PROGUARD
   /variable/CMAKE_ANDROID_PROGUARD_CONFIG_PATH
   /variable/CMAKE_ANDROID_SECURE_PROPS_PATH
   /variable/CMAKE_ANDROID_SKIP_ANT_STEP
318
   /variable/CMAKE_ANDROID_STANDALONE_TOOLCHAIN
319
   /variable/CMAKE_ANDROID_STL_TYPE
320
   /variable/CMAKE_ARCHIVE_OUTPUT_DIRECTORY
321
   /variable/CMAKE_ARCHIVE_OUTPUT_DIRECTORY_CONFIG
322
   /variable/CMAKE_AUTOGEN_ORIGIN_DEPENDS
323
   /variable/CMAKE_AUTOGEN_PARALLEL
324
   /variable/CMAKE_AUTOGEN_VERBOSE
325
   /variable/CMAKE_AUTOMOC
326
   /variable/CMAKE_AUTOMOC_COMPILER_PREDEFINES
327
   /variable/CMAKE_AUTOMOC_DEPEND_FILTERS
328
   /variable/CMAKE_AUTOMOC_MACRO_NAMES
329
   /variable/CMAKE_AUTOMOC_MOC_OPTIONS
330 331
   /variable/CMAKE_AUTORCC
   /variable/CMAKE_AUTORCC_OPTIONS
332 333
   /variable/CMAKE_AUTOUIC
   /variable/CMAKE_AUTOUIC_OPTIONS
334
   /variable/CMAKE_AUTOUIC_SEARCH_PATHS
335
   /variable/CMAKE_BUILD_RPATH
336
   /variable/CMAKE_BUILD_RPATH_USE_ORIGIN
337
   /variable/CMAKE_BUILD_WITH_INSTALL_NAME_DIR
338
   /variable/CMAKE_BUILD_WITH_INSTALL_RPATH
339 340
   /variable/CMAKE_COMPILE_PDB_OUTPUT_DIRECTORY
   /variable/CMAKE_COMPILE_PDB_OUTPUT_DIRECTORY_CONFIG
341
   /variable/CMAKE_CONFIG_POSTFIX
342
   /variable/CMAKE_CUDA_SEPARABLE_COMPILATION
343
   /variable/CMAKE_DEBUG_POSTFIX
344
   /variable/CMAKE_ENABLE_EXPORTS
345
   /variable/CMAKE_EXE_LINKER_FLAGS
346
   /variable/CMAKE_EXE_LINKER_FLAGS_CONFIG
347 348
   /variable/CMAKE_EXE_LINKER_FLAGS_CONFIG_INIT
   /variable/CMAKE_EXE_LINKER_FLAGS_INIT
349
   /variable/CMAKE_FOLDER
350 351
   /variable/CMAKE_Fortran_FORMAT
   /variable/CMAKE_Fortran_MODULE_DIRECTORY
352
   /variable/CMAKE_GHS_NO_SOURCE_GROUP_FILE
353 354 355 356
   /variable/CMAKE_GLOBAL_AUTOGEN_TARGET
   /variable/CMAKE_GLOBAL_AUTOGEN_TARGET_NAME
   /variable/CMAKE_GLOBAL_AUTORCC_TARGET
   /variable/CMAKE_GLOBAL_AUTORCC_TARGET_NAME
357 358
   /variable/CMAKE_GNUtoMS
   /variable/CMAKE_INCLUDE_CURRENT_DIR
359
   /variable/CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE
360 361 362
   /variable/CMAKE_INSTALL_NAME_DIR
   /variable/CMAKE_INSTALL_RPATH
   /variable/CMAKE_INSTALL_RPATH_USE_LINK_PATH
363
   /variable/CMAKE_INTERPROCEDURAL_OPTIMIZATION
364
   /variable/CMAKE_INTERPROCEDURAL_OPTIMIZATION_CONFIG
365
   /variable/CMAKE_IOS_INSTALL_COMBINED
366
   /variable/CMAKE_LANG_CLANG_TIDY
367
   /variable/CMAKE_LANG_COMPILER_LAUNCHER
368
   /variable/CMAKE_LANG_CPPCHECK
369
   /variable/CMAKE_LANG_CPPLINT
370
   /variable/CMAKE_LANG_INCLUDE_WHAT_YOU_USE
371 372
   /variable/CMAKE_LANG_VISIBILITY_PRESET
   /variable/CMAKE_LIBRARY_OUTPUT_DIRECTORY
373
   /variable/CMAKE_LIBRARY_OUTPUT_DIRECTORY_CONFIG
374 375 376 377 378 379
   /variable/CMAKE_LIBRARY_PATH_FLAG
   /variable/CMAKE_LINK_DEF_FILE_FLAG
   /variable/CMAKE_LINK_DEPENDS_NO_SHARED
   /variable/CMAKE_LINK_INTERFACE_LIBRARIES
   /variable/CMAKE_LINK_LIBRARY_FILE_FLAG
   /variable/CMAKE_LINK_LIBRARY_FLAG
380
   /variable/CMAKE_LINK_WHAT_YOU_USE
381
   /variable/CMAKE_MACOSX_BUNDLE
382
   /variable/CMAKE_MACOSX_RPATH
383
   /variable/CMAKE_MAP_IMPORTED_CONFIG_CONFIG
384
   /variable/CMAKE_MODULE_LINKER_FLAGS
385
   /variable/CMAKE_MODULE_LINKER_FLAGS_CONFIG
386 387
   /variable/CMAKE_MODULE_LINKER_FLAGS_CONFIG_INIT
   /variable/CMAKE_MODULE_LINKER_FLAGS_INIT
388
   /variable/CMAKE_MSVCIDE_RUN_PATH
389
   /variable/CMAKE_NINJA_OUTPUT_PATH_PREFIX
390 391
   /variable/CMAKE_NO_BUILTIN_CHRPATH
   /variable/CMAKE_NO_SYSTEM_FROM_IMPORTED
392 393 394
   /variable/CMAKE_OSX_ARCHITECTURES
   /variable/CMAKE_OSX_DEPLOYMENT_TARGET
   /variable/CMAKE_OSX_SYSROOT
395
   /variable/CMAKE_PDB_OUTPUT_DIRECTORY
396
   /variable/CMAKE_PDB_OUTPUT_DIRECTORY_CONFIG
397 398
   /variable/CMAKE_POSITION_INDEPENDENT_CODE
   /variable/CMAKE_RUNTIME_OUTPUT_DIRECTORY
399
   /variable/CMAKE_RUNTIME_OUTPUT_DIRECTORY_CONFIG
400
   /variable/CMAKE_SHARED_LINKER_FLAGS
401
   /variable/CMAKE_SHARED_LINKER_FLAGS_CONFIG
402 403
   /variable/CMAKE_SHARED_LINKER_FLAGS_CONFIG_INIT
   /variable/CMAKE_SHARED_LINKER_FLAGS_INIT
404 405
   /variable/CMAKE_SKIP_BUILD_RPATH
   /variable/CMAKE_SKIP_INSTALL_RPATH
406
   /variable/CMAKE_STATIC_LINKER_FLAGS
407
   /variable/CMAKE_STATIC_LINKER_FLAGS_CONFIG
408 409
   /variable/CMAKE_STATIC_LINKER_FLAGS_CONFIG_INIT
   /variable/CMAKE_STATIC_LINKER_FLAGS_INIT
410
   /variable/CMAKE_TRY_COMPILE_CONFIGURATION
411
   /variable/CMAKE_TRY_COMPILE_PLATFORM_VARIABLES
412
   /variable/CMAKE_TRY_COMPILE_TARGET_TYPE
413 414
   /variable/CMAKE_USE_RELATIVE_PATHS
   /variable/CMAKE_VISIBILITY_INLINES_HIDDEN
415
   /variable/CMAKE_VS_GLOBALS
416
   /variable/CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD
417
   /variable/CMAKE_VS_INCLUDE_PACKAGE_TO_DEFAULT_BUILD
418 419 420 421 422 423 424
   /variable/CMAKE_VS_SDK_EXCLUDE_DIRECTORIES
   /variable/CMAKE_VS_SDK_EXECUTABLE_DIRECTORIES
   /variable/CMAKE_VS_SDK_INCLUDE_DIRECTORIES
   /variable/CMAKE_VS_SDK_LIBRARY_DIRECTORIES
   /variable/CMAKE_VS_SDK_LIBRARY_WINRT_DIRECTORIES
   /variable/CMAKE_VS_SDK_REFERENCE_DIRECTORIES
   /variable/CMAKE_VS_SDK_SOURCE_DIRECTORIES
425
   /variable/CMAKE_VS_WINRT_BY_DEFAULT
426
   /variable/CMAKE_WIN32_EXECUTABLE
427
   /variable/CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS
428
   /variable/CMAKE_XCODE_ATTRIBUTE_an-attribute
429 430 431 432 433 434 435
   /variable/EXECUTABLE_OUTPUT_PATH
   /variable/LIBRARY_OUTPUT_PATH

Variables for Languages
=======================

.. toctree::
436 437
   :maxdepth: 1

438 439 440
   /variable/CMAKE_COMPILER_IS_GNUCC
   /variable/CMAKE_COMPILER_IS_GNUCXX
   /variable/CMAKE_COMPILER_IS_GNUG77
441
   /variable/CMAKE_CUDA_HOST_COMPILER
442 443 444
   /variable/CMAKE_CUDA_EXTENSIONS
   /variable/CMAKE_CUDA_STANDARD
   /variable/CMAKE_CUDA_STANDARD_REQUIRED
445
   /variable/CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES
446
   /variable/CMAKE_CXX_COMPILE_FEATURES
447
   /variable/CMAKE_CXX_EXTENSIONS
448
   /variable/CMAKE_CXX_STANDARD
449
   /variable/CMAKE_CXX_STANDARD_REQUIRED
450 451 452 453
   /variable/CMAKE_C_COMPILE_FEATURES
   /variable/CMAKE_C_EXTENSIONS
   /variable/CMAKE_C_STANDARD
   /variable/CMAKE_C_STANDARD_REQUIRED
454 455 456
   /variable/CMAKE_Fortran_MODDIR_DEFAULT
   /variable/CMAKE_Fortran_MODDIR_FLAG
   /variable/CMAKE_Fortran_MODOUT_FLAG
457
   /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_MACHINE
458 459
   /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_PREFIX
   /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX
460 461 462
   /variable/CMAKE_LANG_ARCHIVE_APPEND
   /variable/CMAKE_LANG_ARCHIVE_CREATE
   /variable/CMAKE_LANG_ARCHIVE_FINISH
463 464
   /variable/CMAKE_LANG_COMPILER
   /variable/CMAKE_LANG_COMPILER_EXTERNAL_TOOLCHAIN
465 466
   /variable/CMAKE_LANG_COMPILER_ID
   /variable/CMAKE_LANG_COMPILER_LOADED
467
   /variable/CMAKE_LANG_COMPILER_PREDEFINES_COMMAND
468
   /variable/CMAKE_LANG_COMPILER_TARGET
469
   /variable/CMAKE_LANG_COMPILER_VERSION
470
   /variable/CMAKE_LANG_COMPILE_OBJECT
471 472 473
   /variable/CMAKE_LANG_CREATE_SHARED_LIBRARY
   /variable/CMAKE_LANG_CREATE_SHARED_MODULE
   /variable/CMAKE_LANG_CREATE_STATIC_LIBRARY
474
   /variable/CMAKE_LANG_FLAGS
475 476
   /variable/CMAKE_LANG_FLAGS_CONFIG
   /variable/CMAKE_LANG_FLAGS_CONFIG_INIT
477
   /variable/CMAKE_LANG_FLAGS_DEBUG
478
   /variable/CMAKE_LANG_FLAGS_DEBUG_INIT
479
   /variable/CMAKE_LANG_FLAGS_INIT
480
   /variable/CMAKE_LANG_FLAGS_MINSIZEREL
481
   /variable/CMAKE_LANG_FLAGS_MINSIZEREL_INIT
482
   /variable/CMAKE_LANG_FLAGS_RELEASE
483
   /variable/CMAKE_LANG_FLAGS_RELEASE_INIT
484
   /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO
485
   /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO_INIT
486 487 488 489 490 491 492
   /variable/CMAKE_LANG_IGNORE_EXTENSIONS
   /variable/CMAKE_LANG_IMPLICIT_INCLUDE_DIRECTORIES
   /variable/CMAKE_LANG_IMPLICIT_LINK_DIRECTORIES
   /variable/CMAKE_LANG_IMPLICIT_LINK_FRAMEWORK_DIRECTORIES
   /variable/CMAKE_LANG_IMPLICIT_LINK_LIBRARIES
   /variable/CMAKE_LANG_LIBRARY_ARCHITECTURE
   /variable/CMAKE_LANG_LINKER_PREFERENCE
493
   /variable/CMAKE_LANG_LINKER_PREFERENCE_PROPAGATES
494 495
   /variable/CMAKE_LANG_LINKER_WRAPPER_FLAG
   /variable/CMAKE_LANG_LINKER_WRAPPER_FLAG_SEP
496 497 498 499 500 501
   /variable/CMAKE_LANG_LINK_EXECUTABLE
   /variable/CMAKE_LANG_OUTPUT_EXTENSION
   /variable/CMAKE_LANG_SIMULATE_ID
   /variable/CMAKE_LANG_SIMULATE_VERSION
   /variable/CMAKE_LANG_SIZEOF_DATA_PTR
   /variable/CMAKE_LANG_SOURCE_FILE_EXTENSIONS
502
   /variable/CMAKE_LANG_STANDARD_INCLUDE_DIRECTORIES
503
   /variable/CMAKE_LANG_STANDARD_LIBRARIES
504
   /variable/CMAKE_Swift_LANGUAGE_VERSION
505 506
   /variable/CMAKE_USER_MAKE_RULES_OVERRIDE_LANG

507 508 509 510 511 512 513 514 515 516 517
Variables for CTest
===================

.. toctree::
   :maxdepth: 1

   /variable/CTEST_BINARY_DIRECTORY
   /variable/CTEST_BUILD_COMMAND
   /variable/CTEST_BUILD_NAME
   /variable/CTEST_BZR_COMMAND
   /variable/CTEST_BZR_UPDATE_OPTIONS
518
   /variable/CTEST_CHANGE_ID
519 520 521 522 523 524
   /variable/CTEST_CHECKOUT_COMMAND
   /variable/CTEST_CONFIGURATION_TYPE
   /variable/CTEST_CONFIGURE_COMMAND
   /variable/CTEST_COVERAGE_COMMAND
   /variable/CTEST_COVERAGE_EXTRA_FLAGS
   /variable/CTEST_CURL_OPTIONS
525 526 527 528 529
   /variable/CTEST_CUSTOM_COVERAGE_EXCLUDE
   /variable/CTEST_CUSTOM_ERROR_EXCEPTION
   /variable/CTEST_CUSTOM_ERROR_MATCH
   /variable/CTEST_CUSTOM_ERROR_POST_CONTEXT
   /variable/CTEST_CUSTOM_ERROR_PRE_CONTEXT
530
   /variable/CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE
531 532
   /variable/CTEST_CUSTOM_MAXIMUM_NUMBER_OF_ERRORS
   /variable/CTEST_CUSTOM_MAXIMUM_NUMBER_OF_WARNINGS
533
   /variable/CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE
534 535 536 537 538
   /variable/CTEST_CUSTOM_MEMCHECK_IGNORE
   /variable/CTEST_CUSTOM_POST_MEMCHECK
   /variable/CTEST_CUSTOM_POST_TEST
   /variable/CTEST_CUSTOM_PRE_MEMCHECK
   /variable/CTEST_CUSTOM_PRE_TEST
539
   /variable/CTEST_CUSTOM_TESTS_IGNORE
540 541
   /variable/CTEST_CUSTOM_WARNING_EXCEPTION
   /variable/CTEST_CUSTOM_WARNING_MATCH
542 543 544 545 546 547 548 549 550
   /variable/CTEST_CVS_CHECKOUT
   /variable/CTEST_CVS_COMMAND
   /variable/CTEST_CVS_UPDATE_OPTIONS
   /variable/CTEST_DROP_LOCATION
   /variable/CTEST_DROP_METHOD
   /variable/CTEST_DROP_SITE
   /variable/CTEST_DROP_SITE_CDASH
   /variable/CTEST_DROP_SITE_PASSWORD
   /variable/CTEST_DROP_SITE_USER
551
   /variable/CTEST_EXTRA_COVERAGE_GLOB
552
   /variable/CTEST_GIT_COMMAND
553
   /variable/CTEST_GIT_INIT_SUBMODULES
554 555 556 557
   /variable/CTEST_GIT_UPDATE_CUSTOM
   /variable/CTEST_GIT_UPDATE_OPTIONS
   /variable/CTEST_HG_COMMAND
   /variable/CTEST_HG_UPDATE_OPTIONS
558
   /variable/CTEST_LABELS_FOR_SUBPROJECTS
559 560
   /variable/CTEST_MEMORYCHECK_COMMAND
   /variable/CTEST_MEMORYCHECK_COMMAND_OPTIONS
561
   /variable/CTEST_MEMORYCHECK_SANITIZER_OPTIONS
562
   /variable/CTEST_MEMORYCHECK_SUPPRESSIONS_FILE
563
   /variable/CTEST_MEMORYCHECK_TYPE
564 565 566 567 568
   /variable/CTEST_NIGHTLY_START_TIME
   /variable/CTEST_P4_CLIENT
   /variable/CTEST_P4_COMMAND
   /variable/CTEST_P4_OPTIONS
   /variable/CTEST_P4_UPDATE_OPTIONS
569
   /variable/CTEST_RUN_CURRENT_SCRIPT
570 571
   /variable/CTEST_SCP_COMMAND
   /variable/CTEST_SITE
572
   /variable/CTEST_SUBMIT_URL
573 574 575 576
   /variable/CTEST_SOURCE_DIRECTORY
   /variable/CTEST_SVN_COMMAND
   /variable/CTEST_SVN_OPTIONS
   /variable/CTEST_SVN_UPDATE_OPTIONS
577
   /variable/CTEST_TEST_LOAD
578 579 580 581
   /variable/CTEST_TEST_TIMEOUT
   /variable/CTEST_TRIGGER_SITE
   /variable/CTEST_UPDATE_COMMAND
   /variable/CTEST_UPDATE_OPTIONS
582
   /variable/CTEST_UPDATE_VERSION_ONLY
583 584
   /variable/CTEST_USE_LAUNCHERS

585 586 587 588
Variables for CPack
===================

.. toctree::
589 590
   :maxdepth: 1

591 592 593 594
   /variable/CPACK_ABSOLUTE_DESTINATION_FILES
   /variable/CPACK_COMPONENT_INCLUDE_TOPLEVEL_DIRECTORY
   /variable/CPACK_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION
   /variable/CPACK_INCLUDE_TOPLEVEL_DIRECTORY
595
   /variable/CPACK_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS
596 597 598 599
   /variable/CPACK_INSTALL_SCRIPT
   /variable/CPACK_PACKAGING_INSTALL_PREFIX
   /variable/CPACK_SET_DESTDIR
   /variable/CPACK_WARN_ON_ABSOLUTE_INSTALL_DESTINATION
600 601 602 603 604 605 606 607 608

Variable Expansion Operators
============================

.. toctree::
   :maxdepth: 1

   /variable/CACHE
   /variable/ENV
609

610
Internal Variables
611 612
==================

613 614 615 616 617
CMake has many internal variables.  Most of them are undocumented.
Some of them, however, were at some point described as normal
variables, and therefore may be encountered in legacy code. They
are subject to change, and not recommended for use in project code.

618 619 620 621
.. toctree::
   :maxdepth: 1

   /variable/CMAKE_HOME_DIRECTORY
622 623 624 625 626 627 628
   /variable/CMAKE_INTERNAL_PLATFORM_ABI
   /variable/CMAKE_LANG_COMPILER_ABI
   /variable/CMAKE_LANG_COMPILER_ARCHITECTURE_ID
   /variable/CMAKE_LANG_COMPILER_VERSION_INTERNAL
   /variable/CMAKE_LANG_PLATFORM_ID
   /variable/CMAKE_NOT_USING_CONFIG_FLAGS
   /variable/CMAKE_VS_INTEL_Fortran_PROJECT_VERSION