cmake-variables.7.rst 26 KB

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