cmake-variables.7.rst 21.9 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_NO_PACKAGE_REGISTRY
163
164
   /variable/CMAKE_FIND_APPBUNDLE
   /variable/CMAKE_FIND_FRAMEWORK
165
   /variable/CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX
166
167
   /variable/CMAKE_FIND_LIBRARY_PREFIXES
   /variable/CMAKE_FIND_LIBRARY_SUFFIXES
168
   /variable/CMAKE_FIND_NO_INSTALL_PREFIX
169
170
   /variable/CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY
   /variable/CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY
171
   /variable/CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS
172
173
174
175
176
177
   /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
178
   /variable/CMAKE_FRAMEWORK_PATH
179
   /variable/CMAKE_IGNORE_PATH
180
181
   /variable/CMAKE_INCLUDE_DIRECTORIES_BEFORE
   /variable/CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE
182
   /variable/CMAKE_INCLUDE_PATH
183
   /variable/CMAKE_INSTALL_DEFAULT_COMPONENT_NAME
184
   /variable/CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS
185
   /variable/CMAKE_INSTALL_MESSAGE
186
   /variable/CMAKE_INSTALL_PREFIX
187
   /variable/CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT
188
   /variable/CMAKE_LIBRARY_PATH
189
   /variable/CMAKE_LINK_DIRECTORIES_BEFORE
190
   /variable/CMAKE_MFC_FLAG
191
   /variable/CMAKE_MAXIMUM_RECURSION_DEPTH
192
193
   /variable/CMAKE_MODULE_PATH
   /variable/CMAKE_POLICY_DEFAULT_CMPNNNN
194
   /variable/CMAKE_POLICY_WARNING_CMPNNNN
195
196
   /variable/CMAKE_PREFIX_PATH
   /variable/CMAKE_PROGRAM_PATH
197
   /variable/CMAKE_PROJECT_PROJECT-NAME_INCLUDE
198
   /variable/CMAKE_SKIP_INSTALL_ALL_DEPENDENCY
199
   /variable/CMAKE_STAGING_PREFIX
200
   /variable/CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS
201
   /variable/CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE
202
   /variable/CMAKE_SUPPRESS_REGENERATION
203
   /variable/CMAKE_SYSROOT
204
205
   /variable/CMAKE_SYSROOT_COMPILE
   /variable/CMAKE_SYSROOT_LINK
206
   /variable/CMAKE_SYSTEM_APPBUNDLE_PATH
207
   /variable/CMAKE_SYSTEM_FRAMEWORK_PATH
208
209
210
211
212
213
214
215
   /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
216
   /variable/CMAKE_XCODE_GENERATE_TOP_LEVEL_PROJECT_ONLY
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
   /variable/CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER
   /variable/CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN
   /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_DISABLE_MAIN_THREAD_CHECKER
   /variable/CMAKE_XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP
   /variable/CMAKE_XCODE_SCHEME_MALLOC_SCRIBBLE
   /variable/CMAKE_XCODE_SCHEME_MALLOC_GUARD_EDGES
   /variable/CMAKE_XCODE_SCHEME_GUARD_MALLOC
   /variable/CMAKE_XCODE_SCHEME_ZOMBIE_OBJECTS
   /variable/CMAKE_XCODE_SCHEME_MALLOC_STACK
   /variable/CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE
   /variable/CMAKE_XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS
232
   /variable/PackageName_ROOT
233
234
235
236
237

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

.. toctree::
238
239
   :maxdepth: 1

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

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

.. toctree::
288
289
   :maxdepth: 1

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

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

.. toctree::
430
431
   :maxdepth: 1

432
433
434
   /variable/CMAKE_COMPILER_IS_GNUCC
   /variable/CMAKE_COMPILER_IS_GNUCXX
   /variable/CMAKE_COMPILER_IS_GNUG77
435
   /variable/CMAKE_CUDA_HOST_COMPILER
436
437
438
   /variable/CMAKE_CUDA_EXTENSIONS
   /variable/CMAKE_CUDA_STANDARD
   /variable/CMAKE_CUDA_STANDARD_REQUIRED
439
   /variable/CMAKE_CUDA_TOOLKIT_INCLUDE_DIRECTORIES
440
   /variable/CMAKE_CXX_COMPILE_FEATURES
441
   /variable/CMAKE_CXX_EXTENSIONS
442
   /variable/CMAKE_CXX_STANDARD
443
   /variable/CMAKE_CXX_STANDARD_REQUIRED
444
445
446
447
   /variable/CMAKE_C_COMPILE_FEATURES
   /variable/CMAKE_C_EXTENSIONS
   /variable/CMAKE_C_STANDARD
   /variable/CMAKE_C_STANDARD_REQUIRED
448
449
450
   /variable/CMAKE_Fortran_MODDIR_DEFAULT
   /variable/CMAKE_Fortran_MODDIR_FLAG
   /variable/CMAKE_Fortran_MODOUT_FLAG
451
   /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_MACHINE
452
453
   /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_PREFIX
   /variable/CMAKE_LANG_ANDROID_TOOLCHAIN_SUFFIX
454
455
456
   /variable/CMAKE_LANG_ARCHIVE_APPEND
   /variable/CMAKE_LANG_ARCHIVE_CREATE
   /variable/CMAKE_LANG_ARCHIVE_FINISH
457
458
   /variable/CMAKE_LANG_COMPILER
   /variable/CMAKE_LANG_COMPILER_EXTERNAL_TOOLCHAIN
459
460
   /variable/CMAKE_LANG_COMPILER_ID
   /variable/CMAKE_LANG_COMPILER_LOADED
461
   /variable/CMAKE_LANG_COMPILER_PREDEFINES_COMMAND
462
   /variable/CMAKE_LANG_COMPILER_TARGET
463
   /variable/CMAKE_LANG_COMPILER_VERSION
464
   /variable/CMAKE_LANG_COMPILE_OBJECT
465
466
467
   /variable/CMAKE_LANG_CREATE_SHARED_LIBRARY
   /variable/CMAKE_LANG_CREATE_SHARED_MODULE
   /variable/CMAKE_LANG_CREATE_STATIC_LIBRARY
468
   /variable/CMAKE_LANG_FLAGS
469
470
   /variable/CMAKE_LANG_FLAGS_CONFIG
   /variable/CMAKE_LANG_FLAGS_CONFIG_INIT
471
   /variable/CMAKE_LANG_FLAGS_DEBUG
472
   /variable/CMAKE_LANG_FLAGS_DEBUG_INIT
473
   /variable/CMAKE_LANG_FLAGS_INIT
474
   /variable/CMAKE_LANG_FLAGS_MINSIZEREL
475
   /variable/CMAKE_LANG_FLAGS_MINSIZEREL_INIT
476
   /variable/CMAKE_LANG_FLAGS_RELEASE
477
   /variable/CMAKE_LANG_FLAGS_RELEASE_INIT
478
   /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO
479
   /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO_INIT
480
481
482
483
484
485
486
   /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
487
   /variable/CMAKE_LANG_LINKER_PREFERENCE_PROPAGATES
488
489
   /variable/CMAKE_LANG_LINKER_WRAPPER_FLAG
   /variable/CMAKE_LANG_LINKER_WRAPPER_FLAG_SEP
490
491
492
493
494
495
   /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
496
   /variable/CMAKE_LANG_STANDARD_INCLUDE_DIRECTORIES
497
   /variable/CMAKE_LANG_STANDARD_LIBRARIES
498
   /variable/CMAKE_Swift_LANGUAGE_VERSION
499
500
   /variable/CMAKE_USER_MAKE_RULES_OVERRIDE_LANG

501
502
503
504
505
506
507
508
509
510
511
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
512
   /variable/CTEST_CHANGE_ID
513
514
515
516
517
518
   /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
519
520
521
522
523
   /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
524
   /variable/CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE
525
526
   /variable/CTEST_CUSTOM_MAXIMUM_NUMBER_OF_ERRORS
   /variable/CTEST_CUSTOM_MAXIMUM_NUMBER_OF_WARNINGS
527
   /variable/CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE
528
529
530
531
532
   /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
533
   /variable/CTEST_CUSTOM_TESTS_IGNORE
534
535
   /variable/CTEST_CUSTOM_WARNING_EXCEPTION
   /variable/CTEST_CUSTOM_WARNING_MATCH
536
537
538
539
540
541
542
543
544
   /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
545
   /variable/CTEST_EXTRA_COVERAGE_GLOB
546
   /variable/CTEST_GIT_COMMAND
547
   /variable/CTEST_GIT_INIT_SUBMODULES
548
549
550
551
   /variable/CTEST_GIT_UPDATE_CUSTOM
   /variable/CTEST_GIT_UPDATE_OPTIONS
   /variable/CTEST_HG_COMMAND
   /variable/CTEST_HG_UPDATE_OPTIONS
552
   /variable/CTEST_LABELS_FOR_SUBPROJECTS
553
554
   /variable/CTEST_MEMORYCHECK_COMMAND
   /variable/CTEST_MEMORYCHECK_COMMAND_OPTIONS
555
   /variable/CTEST_MEMORYCHECK_SANITIZER_OPTIONS
556
   /variable/CTEST_MEMORYCHECK_SUPPRESSIONS_FILE
557
   /variable/CTEST_MEMORYCHECK_TYPE
558
559
560
561
562
   /variable/CTEST_NIGHTLY_START_TIME
   /variable/CTEST_P4_CLIENT
   /variable/CTEST_P4_COMMAND
   /variable/CTEST_P4_OPTIONS
   /variable/CTEST_P4_UPDATE_OPTIONS
563
   /variable/CTEST_RUN_CURRENT_SCRIPT
564
565
   /variable/CTEST_SCP_COMMAND
   /variable/CTEST_SITE
566
   /variable/CTEST_SUBMIT_URL
567
568
569
570
   /variable/CTEST_SOURCE_DIRECTORY
   /variable/CTEST_SVN_COMMAND
   /variable/CTEST_SVN_OPTIONS
   /variable/CTEST_SVN_UPDATE_OPTIONS
571
   /variable/CTEST_TEST_LOAD
572
573
574
575
   /variable/CTEST_TEST_TIMEOUT
   /variable/CTEST_TRIGGER_SITE
   /variable/CTEST_UPDATE_COMMAND
   /variable/CTEST_UPDATE_OPTIONS
576
   /variable/CTEST_UPDATE_VERSION_ONLY
577
578
   /variable/CTEST_USE_LAUNCHERS

579
580
581
582
Variables for CPack
===================

.. toctree::
583
584
   :maxdepth: 1

585
586
587
588
   /variable/CPACK_ABSOLUTE_DESTINATION_FILES
   /variable/CPACK_COMPONENT_INCLUDE_TOPLEVEL_DIRECTORY
   /variable/CPACK_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION
   /variable/CPACK_INCLUDE_TOPLEVEL_DIRECTORY
589
   /variable/CPACK_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS
590
591
592
593
   /variable/CPACK_INSTALL_SCRIPT
   /variable/CPACK_PACKAGING_INSTALL_PREFIX
   /variable/CPACK_SET_DESTDIR
   /variable/CPACK_WARN_ON_ABSOLUTE_INSTALL_DESTINATION
594
595
596
597
598
599
600
601
602

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

.. toctree::
   :maxdepth: 1

   /variable/CACHE
   /variable/ENV
603

604
Internal Variables
605
606
==================

607
608
609
610
611
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.

612
613
614
615
.. toctree::
   :maxdepth: 1

   /variable/CMAKE_HOME_DIRECTORY
616
617
618
619
620
621
622
   /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