cmake-variables.7.rst 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293
  1. .. cmake-manual-description: CMake Variables Reference
  2. cmake-variables(7)
  3. ******************
  4. .. only:: html or latex
  5. .. contents::
  6. Variables that Provide Information
  7. ==================================
  8. .. toctree::
  9. :maxdepth: 1
  10. /variable/CMAKE_ARGC
  11. /variable/CMAKE_ARGV0
  12. /variable/CMAKE_AR
  13. /variable/CMAKE_BINARY_DIR
  14. /variable/CMAKE_BUILD_TOOL
  15. /variable/CMAKE_CACHEFILE_DIR
  16. /variable/CMAKE_CACHE_MAJOR_VERSION
  17. /variable/CMAKE_CACHE_MINOR_VERSION
  18. /variable/CMAKE_CACHE_PATCH_VERSION
  19. /variable/CMAKE_CFG_INTDIR
  20. /variable/CMAKE_COMMAND
  21. /variable/CMAKE_CROSSCOMPILING
  22. /variable/CMAKE_CTEST_COMMAND
  23. /variable/CMAKE_CURRENT_BINARY_DIR
  24. /variable/CMAKE_CURRENT_LIST_DIR
  25. /variable/CMAKE_CURRENT_LIST_FILE
  26. /variable/CMAKE_CURRENT_LIST_LINE
  27. /variable/CMAKE_CURRENT_SOURCE_DIR
  28. /variable/CMAKE_DL_LIBS
  29. /variable/CMAKE_EDIT_COMMAND
  30. /variable/CMAKE_EXECUTABLE_SUFFIX
  31. /variable/CMAKE_EXTRA_GENERATOR
  32. /variable/CMAKE_EXTRA_SHARED_LIBRARY_SUFFIXES
  33. /variable/CMAKE_GENERATOR
  34. /variable/CMAKE_GENERATOR_TOOLSET
  35. /variable/CMAKE_HOME_DIRECTORY
  36. /variable/CMAKE_IMPORT_LIBRARY_PREFIX
  37. /variable/CMAKE_IMPORT_LIBRARY_SUFFIX
  38. /variable/CMAKE_JOB_POOL_COMPILE
  39. /variable/CMAKE_JOB_POOL_LINK
  40. /variable/CMAKE_LINK_LIBRARY_SUFFIX
  41. /variable/CMAKE_MAJOR_VERSION
  42. /variable/CMAKE_MAKE_PROGRAM
  43. /variable/CMAKE_MINIMUM_REQUIRED_VERSION
  44. /variable/CMAKE_MINOR_VERSION
  45. /variable/CMAKE_PARENT_LIST_FILE
  46. /variable/CMAKE_PATCH_VERSION
  47. /variable/CMAKE_PROJECT_NAME
  48. /variable/CMAKE_RANLIB
  49. /variable/CMAKE_ROOT
  50. /variable/CMAKE_SCRIPT_MODE_FILE
  51. /variable/CMAKE_SHARED_LIBRARY_PREFIX
  52. /variable/CMAKE_SHARED_LIBRARY_SUFFIX
  53. /variable/CMAKE_SHARED_MODULE_PREFIX
  54. /variable/CMAKE_SHARED_MODULE_SUFFIX
  55. /variable/CMAKE_SIZEOF_VOID_P
  56. /variable/CMAKE_SKIP_RPATH
  57. /variable/CMAKE_SOURCE_DIR
  58. /variable/CMAKE_STANDARD_LIBRARIES
  59. /variable/CMAKE_STATIC_LIBRARY_PREFIX
  60. /variable/CMAKE_STATIC_LIBRARY_SUFFIX
  61. /variable/CMAKE_TOOLCHAIN_FILE
  62. /variable/CMAKE_TWEAK_VERSION
  63. /variable/CMAKE_VERBOSE_MAKEFILE
  64. /variable/CMAKE_VERSION
  65. /variable/CMAKE_VS_DEVENV_COMMAND
  66. /variable/CMAKE_VS_INTEL_Fortran_PROJECT_VERSION
  67. /variable/CMAKE_VS_MSBUILD_COMMAND
  68. /variable/CMAKE_VS_MSDEV_COMMAND
  69. /variable/CMAKE_VS_PLATFORM_TOOLSET
  70. /variable/CMAKE_XCODE_PLATFORM_TOOLSET
  71. /variable/PROJECT_BINARY_DIR
  72. /variable/PROJECT-NAME_BINARY_DIR
  73. /variable/PROJECT_NAME
  74. /variable/PROJECT-NAME_SOURCE_DIR
  75. /variable/PROJECT_SOURCE_DIR
  76. Variables that Change Behavior
  77. ==============================
  78. .. toctree::
  79. :maxdepth: 1
  80. /variable/BUILD_SHARED_LIBS
  81. /variable/CMAKE_ABSOLUTE_DESTINATION_FILES
  82. /variable/CMAKE_AUTOMOC_RELAXED_MODE
  83. /variable/CMAKE_BACKWARDS_COMPATIBILITY
  84. /variable/CMAKE_BUILD_TYPE
  85. /variable/CMAKE_COLOR_MAKEFILE
  86. /variable/CMAKE_CONFIGURATION_TYPES
  87. /variable/CMAKE_DEBUG_TARGET_PROPERTIES
  88. /variable/CMAKE_DISABLE_FIND_PACKAGE_PackageName
  89. /variable/CMAKE_ERROR_DEPRECATED
  90. /variable/CMAKE_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION
  91. /variable/CMAKE_SYSROOT
  92. /variable/CMAKE_FIND_LIBRARY_PREFIXES
  93. /variable/CMAKE_FIND_LIBRARY_SUFFIXES
  94. /variable/CMAKE_FIND_NO_INSTALL_PREFIX
  95. /variable/CMAKE_FIND_PACKAGE_WARN_NO_MODULE
  96. /variable/CMAKE_FIND_ROOT_PATH
  97. /variable/CMAKE_FIND_ROOT_PATH_MODE_INCLUDE
  98. /variable/CMAKE_FIND_ROOT_PATH_MODE_LIBRARY
  99. /variable/CMAKE_FIND_ROOT_PATH_MODE_PACKAGE
  100. /variable/CMAKE_FIND_ROOT_PATH_MODE_PROGRAM
  101. /variable/CMAKE_IGNORE_PATH
  102. /variable/CMAKE_INCLUDE_PATH
  103. /variable/CMAKE_INCLUDE_DIRECTORIES_BEFORE
  104. /variable/CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE
  105. /variable/CMAKE_INSTALL_DEFAULT_COMPONENT_NAME
  106. /variable/CMAKE_INSTALL_PREFIX
  107. /variable/CMAKE_LIBRARY_PATH
  108. /variable/CMAKE_MFC_FLAG
  109. /variable/CMAKE_MODULE_PATH
  110. /variable/CMAKE_NOT_USING_CONFIG_FLAGS
  111. /variable/CMAKE_POLICY_DEFAULT_CMPNNNN
  112. /variable/CMAKE_PREFIX_PATH
  113. /variable/CMAKE_PROGRAM_PATH
  114. /variable/CMAKE_SKIP_INSTALL_ALL_DEPENDENCY
  115. /variable/CMAKE_STAGING_PREFIX
  116. /variable/CMAKE_SYSTEM_IGNORE_PATH
  117. /variable/CMAKE_SYSTEM_INCLUDE_PATH
  118. /variable/CMAKE_SYSTEM_LIBRARY_PATH
  119. /variable/CMAKE_SYSTEM_PREFIX_PATH
  120. /variable/CMAKE_SYSTEM_PROGRAM_PATH
  121. /variable/CMAKE_USER_MAKE_RULES_OVERRIDE
  122. /variable/CMAKE_WARN_DEPRECATED
  123. /variable/CMAKE_WARN_ON_ABSOLUTE_INSTALL_DESTINATION
  124. Variables that Describe the System
  125. ==================================
  126. .. toctree::
  127. :maxdepth: 1
  128. /variable/APPLE
  129. /variable/BORLAND
  130. /variable/CMAKE_CL_64
  131. /variable/CMAKE_COMPILER_2005
  132. /variable/CMAKE_HOST_APPLE
  133. /variable/CMAKE_HOST_SYSTEM_NAME
  134. /variable/CMAKE_HOST_SYSTEM_PROCESSOR
  135. /variable/CMAKE_HOST_SYSTEM
  136. /variable/CMAKE_HOST_SYSTEM_VERSION
  137. /variable/CMAKE_HOST_UNIX
  138. /variable/CMAKE_HOST_WIN32
  139. /variable/CMAKE_LIBRARY_ARCHITECTURE_REGEX
  140. /variable/CMAKE_LIBRARY_ARCHITECTURE
  141. /variable/CMAKE_OBJECT_PATH_MAX
  142. /variable/CMAKE_SYSTEM_NAME
  143. /variable/CMAKE_SYSTEM_PROCESSOR
  144. /variable/CMAKE_SYSTEM
  145. /variable/CMAKE_SYSTEM_VERSION
  146. /variable/CYGWIN
  147. /variable/ENV
  148. /variable/MSVC10
  149. /variable/MSVC11
  150. /variable/MSVC12
  151. /variable/MSVC60
  152. /variable/MSVC70
  153. /variable/MSVC71
  154. /variable/MSVC80
  155. /variable/MSVC90
  156. /variable/MSVC_IDE
  157. /variable/MSVC
  158. /variable/MSVC_VERSION
  159. /variable/UNIX
  160. /variable/WIN32
  161. /variable/XCODE_VERSION
  162. Variables that Control the Build
  163. ================================
  164. .. toctree::
  165. :maxdepth: 1
  166. /variable/CMAKE_ARCHIVE_OUTPUT_DIRECTORY
  167. /variable/CMAKE_AUTOMOC_MOC_OPTIONS
  168. /variable/CMAKE_AUTOMOC
  169. /variable/CMAKE_AUTORCC
  170. /variable/CMAKE_AUTORCC_OPTIONS
  171. /variable/CMAKE_AUTOUIC
  172. /variable/CMAKE_AUTOUIC_OPTIONS
  173. /variable/CMAKE_BUILD_WITH_INSTALL_RPATH
  174. /variable/CMAKE_CONFIG_POSTFIX
  175. /variable/CMAKE_DEBUG_POSTFIX
  176. /variable/CMAKE_EXE_LINKER_FLAGS_CONFIG
  177. /variable/CMAKE_EXE_LINKER_FLAGS
  178. /variable/CMAKE_Fortran_FORMAT
  179. /variable/CMAKE_Fortran_MODULE_DIRECTORY
  180. /variable/CMAKE_GNUtoMS
  181. /variable/CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE
  182. /variable/CMAKE_INCLUDE_CURRENT_DIR
  183. /variable/CMAKE_INSTALL_NAME_DIR
  184. /variable/CMAKE_INSTALL_RPATH
  185. /variable/CMAKE_INSTALL_RPATH_USE_LINK_PATH
  186. /variable/CMAKE_LANG_VISIBILITY_PRESET
  187. /variable/CMAKE_LIBRARY_OUTPUT_DIRECTORY
  188. /variable/CMAKE_LIBRARY_PATH_FLAG
  189. /variable/CMAKE_LINK_DEF_FILE_FLAG
  190. /variable/CMAKE_LINK_DEPENDS_NO_SHARED
  191. /variable/CMAKE_LINK_INTERFACE_LIBRARIES
  192. /variable/CMAKE_LINK_LIBRARY_FILE_FLAG
  193. /variable/CMAKE_LINK_LIBRARY_FLAG
  194. /variable/CMAKE_MACOSX_BUNDLE
  195. /variable/CMAKE_MACOSX_RPATH
  196. /variable/CMAKE_MAP_IMPORTED_CONFIG_CONFIG
  197. /variable/CMAKE_MODULE_LINKER_FLAGS_CONFIG
  198. /variable/CMAKE_MODULE_LINKER_FLAGS
  199. /variable/CMAKE_NO_BUILTIN_CHRPATH
  200. /variable/CMAKE_NO_SYSTEM_FROM_IMPORTED
  201. /variable/CMAKE_PDB_OUTPUT_DIRECTORY
  202. /variable/CMAKE_PDB_OUTPUT_DIRECTORY_CONFIG
  203. /variable/CMAKE_POSITION_INDEPENDENT_CODE
  204. /variable/CMAKE_RUNTIME_OUTPUT_DIRECTORY
  205. /variable/CMAKE_SHARED_LINKER_FLAGS_CONFIG
  206. /variable/CMAKE_SHARED_LINKER_FLAGS
  207. /variable/CMAKE_SKIP_BUILD_RPATH
  208. /variable/CMAKE_SKIP_INSTALL_RPATH
  209. /variable/CMAKE_STATIC_LINKER_FLAGS_CONFIG
  210. /variable/CMAKE_STATIC_LINKER_FLAGS
  211. /variable/CMAKE_TRY_COMPILE_CONFIGURATION
  212. /variable/CMAKE_USE_RELATIVE_PATHS
  213. /variable/CMAKE_VISIBILITY_INLINES_HIDDEN
  214. /variable/CMAKE_WIN32_EXECUTABLE
  215. /variable/EXECUTABLE_OUTPUT_PATH
  216. /variable/LIBRARY_OUTPUT_PATH
  217. Variables for Languages
  218. =======================
  219. .. toctree::
  220. :maxdepth: 1
  221. /variable/CMAKE_COMPILER_IS_GNULANG
  222. /variable/CMAKE_Fortran_MODDIR_DEFAULT
  223. /variable/CMAKE_Fortran_MODDIR_FLAG
  224. /variable/CMAKE_Fortran_MODOUT_FLAG
  225. /variable/CMAKE_INTERNAL_PLATFORM_ABI
  226. /variable/CMAKE_LANG_ARCHIVE_APPEND
  227. /variable/CMAKE_LANG_ARCHIVE_CREATE
  228. /variable/CMAKE_LANG_ARCHIVE_FINISH
  229. /variable/CMAKE_LANG_COMPILE_OBJECT
  230. /variable/CMAKE_LANG_COMPILER_ABI
  231. /variable/CMAKE_LANG_COMPILER_ID
  232. /variable/CMAKE_LANG_COMPILER_LOADED
  233. /variable/CMAKE_LANG_COMPILER
  234. /variable/CMAKE_LANG_COMPILER_EXTERNAL_TOOLCHAIN
  235. /variable/CMAKE_LANG_COMPILER_TARGET
  236. /variable/CMAKE_LANG_COMPILER_VERSION
  237. /variable/CMAKE_LANG_CREATE_SHARED_LIBRARY
  238. /variable/CMAKE_LANG_CREATE_SHARED_MODULE
  239. /variable/CMAKE_LANG_CREATE_STATIC_LIBRARY
  240. /variable/CMAKE_LANG_FLAGS_DEBUG
  241. /variable/CMAKE_LANG_FLAGS_MINSIZEREL
  242. /variable/CMAKE_LANG_FLAGS_RELEASE
  243. /variable/CMAKE_LANG_FLAGS_RELWITHDEBINFO
  244. /variable/CMAKE_LANG_FLAGS
  245. /variable/CMAKE_LANG_IGNORE_EXTENSIONS
  246. /variable/CMAKE_LANG_IMPLICIT_INCLUDE_DIRECTORIES
  247. /variable/CMAKE_LANG_IMPLICIT_LINK_DIRECTORIES
  248. /variable/CMAKE_LANG_IMPLICIT_LINK_FRAMEWORK_DIRECTORIES
  249. /variable/CMAKE_LANG_IMPLICIT_LINK_LIBRARIES
  250. /variable/CMAKE_LANG_LIBRARY_ARCHITECTURE
  251. /variable/CMAKE_LANG_LINKER_PREFERENCE_PROPAGATES
  252. /variable/CMAKE_LANG_LINKER_PREFERENCE
  253. /variable/CMAKE_LANG_LINK_EXECUTABLE
  254. /variable/CMAKE_LANG_OUTPUT_EXTENSION
  255. /variable/CMAKE_LANG_PLATFORM_ID
  256. /variable/CMAKE_LANG_SIMULATE_ID
  257. /variable/CMAKE_LANG_SIMULATE_VERSION
  258. /variable/CMAKE_LANG_SIZEOF_DATA_PTR
  259. /variable/CMAKE_LANG_SOURCE_FILE_EXTENSIONS
  260. /variable/CMAKE_USER_MAKE_RULES_OVERRIDE_LANG
  261. Variables for CPack
  262. ===================
  263. .. toctree::
  264. :maxdepth: 1
  265. /variable/CPACK_ABSOLUTE_DESTINATION_FILES
  266. /variable/CPACK_COMPONENT_INCLUDE_TOPLEVEL_DIRECTORY
  267. /variable/CPACK_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION
  268. /variable/CPACK_INCLUDE_TOPLEVEL_DIRECTORY
  269. /variable/CPACK_INSTALL_SCRIPT
  270. /variable/CPACK_PACKAGING_INSTALL_PREFIX
  271. /variable/CPACK_SET_DESTDIR
  272. /variable/CPACK_WARN_ON_ABSOLUTE_INSTALL_DESTINATION