cmake-properties.7.rst 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377
  1. .. cmake-manual-description: CMake Properties Reference
  2. cmake-properties(7)
  3. *******************
  4. .. only:: html
  5. .. contents::
  6. .. _`Global Properties`:
  7. Properties of Global Scope
  8. ==========================
  9. .. toctree::
  10. :maxdepth: 1
  11. /prop_gbl/ALLOW_DUPLICATE_CUSTOM_TARGETS
  12. /prop_gbl/AUTOGEN_TARGETS_FOLDER
  13. /prop_gbl/AUTOMOC_TARGETS_FOLDER
  14. /prop_gbl/CMAKE_C_KNOWN_FEATURES
  15. /prop_gbl/CMAKE_CXX_KNOWN_FEATURES
  16. /prop_gbl/DEBUG_CONFIGURATIONS
  17. /prop_gbl/DISABLED_FEATURES
  18. /prop_gbl/ENABLED_FEATURES
  19. /prop_gbl/ENABLED_LANGUAGES
  20. /prop_gbl/FIND_LIBRARY_USE_LIB64_PATHS
  21. /prop_gbl/FIND_LIBRARY_USE_OPENBSD_VERSIONING
  22. /prop_gbl/GLOBAL_DEPENDS_DEBUG_MODE
  23. /prop_gbl/GLOBAL_DEPENDS_NO_CYCLES
  24. /prop_gbl/IN_TRY_COMPILE
  25. /prop_gbl/PACKAGES_FOUND
  26. /prop_gbl/PACKAGES_NOT_FOUND
  27. /prop_gbl/JOB_POOLS
  28. /prop_gbl/PREDEFINED_TARGETS_FOLDER
  29. /prop_gbl/ECLIPSE_EXTRA_NATURES
  30. /prop_gbl/REPORT_UNDEFINED_PROPERTIES
  31. /prop_gbl/RULE_LAUNCH_COMPILE
  32. /prop_gbl/RULE_LAUNCH_CUSTOM
  33. /prop_gbl/RULE_LAUNCH_LINK
  34. /prop_gbl/RULE_MESSAGES
  35. /prop_gbl/TARGET_ARCHIVES_MAY_BE_SHARED_LIBS
  36. /prop_gbl/TARGET_SUPPORTS_SHARED_LIBS
  37. /prop_gbl/USE_FOLDERS
  38. .. _`Directory Properties`:
  39. Properties on Directories
  40. =========================
  41. .. toctree::
  42. :maxdepth: 1
  43. /prop_dir/ADDITIONAL_MAKE_CLEAN_FILES
  44. /prop_dir/CACHE_VARIABLES
  45. /prop_dir/CLEAN_NO_CUSTOM
  46. /prop_dir/CMAKE_CONFIGURE_DEPENDS
  47. /prop_dir/COMPILE_DEFINITIONS
  48. /prop_dir/COMPILE_OPTIONS
  49. /prop_dir/DEFINITIONS
  50. /prop_dir/EXCLUDE_FROM_ALL
  51. /prop_dir/IMPLICIT_DEPENDS_INCLUDE_TRANSFORM
  52. /prop_dir/INCLUDE_DIRECTORIES
  53. /prop_dir/INCLUDE_REGULAR_EXPRESSION
  54. /prop_dir/INTERPROCEDURAL_OPTIMIZATION_CONFIG
  55. /prop_dir/INTERPROCEDURAL_OPTIMIZATION
  56. /prop_dir/LINK_DIRECTORIES
  57. /prop_dir/LISTFILE_STACK
  58. /prop_dir/MACROS
  59. /prop_dir/PARENT_DIRECTORY
  60. /prop_dir/RULE_LAUNCH_COMPILE
  61. /prop_dir/RULE_LAUNCH_CUSTOM
  62. /prop_dir/RULE_LAUNCH_LINK
  63. /prop_dir/TEST_INCLUDE_FILE
  64. /prop_dir/VARIABLES
  65. /prop_dir/VS_GLOBAL_SECTION_POST_section
  66. /prop_dir/VS_GLOBAL_SECTION_PRE_section
  67. .. _`Target Properties`:
  68. Properties on Targets
  69. =====================
  70. .. toctree::
  71. :maxdepth: 1
  72. /prop_tgt/ALIASED_TARGET
  73. /prop_tgt/ANDROID_API
  74. /prop_tgt/ANDROID_API_MIN
  75. /prop_tgt/ANDROID_GUI
  76. /prop_tgt/ARCHIVE_OUTPUT_DIRECTORY_CONFIG
  77. /prop_tgt/ARCHIVE_OUTPUT_DIRECTORY
  78. /prop_tgt/ARCHIVE_OUTPUT_NAME_CONFIG
  79. /prop_tgt/ARCHIVE_OUTPUT_NAME
  80. /prop_tgt/AUTOGEN_TARGET_DEPENDS
  81. /prop_tgt/AUTOMOC_MOC_OPTIONS
  82. /prop_tgt/AUTOMOC
  83. /prop_tgt/AUTOUIC
  84. /prop_tgt/AUTOUIC_OPTIONS
  85. /prop_tgt/AUTORCC
  86. /prop_tgt/AUTORCC_OPTIONS
  87. /prop_tgt/BUILD_WITH_INSTALL_RPATH
  88. /prop_tgt/BUNDLE_EXTENSION
  89. /prop_tgt/BUNDLE
  90. /prop_tgt/C_EXTENSIONS
  91. /prop_tgt/C_STANDARD
  92. /prop_tgt/C_STANDARD_REQUIRED
  93. /prop_tgt/COMPATIBLE_INTERFACE_BOOL
  94. /prop_tgt/COMPATIBLE_INTERFACE_NUMBER_MAX
  95. /prop_tgt/COMPATIBLE_INTERFACE_NUMBER_MIN
  96. /prop_tgt/COMPATIBLE_INTERFACE_STRING
  97. /prop_tgt/COMPILE_DEFINITIONS
  98. /prop_tgt/COMPILE_FEATURES
  99. /prop_tgt/COMPILE_FLAGS
  100. /prop_tgt/COMPILE_OPTIONS
  101. /prop_tgt/COMPILE_PDB_NAME
  102. /prop_tgt/COMPILE_PDB_NAME_CONFIG
  103. /prop_tgt/COMPILE_PDB_OUTPUT_DIRECTORY
  104. /prop_tgt/COMPILE_PDB_OUTPUT_DIRECTORY_CONFIG
  105. /prop_tgt/CONFIG_OUTPUT_NAME
  106. /prop_tgt/CONFIG_POSTFIX
  107. /prop_tgt/CROSSCOMPILING_EMULATOR
  108. /prop_tgt/CXX_EXTENSIONS
  109. /prop_tgt/CXX_STANDARD
  110. /prop_tgt/CXX_STANDARD_REQUIRED
  111. /prop_tgt/DEBUG_POSTFIX
  112. /prop_tgt/DEFINE_SYMBOL
  113. /prop_tgt/EchoString
  114. /prop_tgt/ENABLE_EXPORTS
  115. /prop_tgt/EXCLUDE_FROM_ALL
  116. /prop_tgt/EXCLUDE_FROM_DEFAULT_BUILD_CONFIG
  117. /prop_tgt/EXCLUDE_FROM_DEFAULT_BUILD
  118. /prop_tgt/EXPORT_NAME
  119. /prop_tgt/FOLDER
  120. /prop_tgt/Fortran_FORMAT
  121. /prop_tgt/Fortran_MODULE_DIRECTORY
  122. /prop_tgt/FRAMEWORK
  123. /prop_tgt/GENERATOR_FILE_NAME
  124. /prop_tgt/GNUtoMS
  125. /prop_tgt/HAS_CXX
  126. /prop_tgt/IMPLICIT_DEPENDS_INCLUDE_TRANSFORM
  127. /prop_tgt/IMPORTED_CONFIGURATIONS
  128. /prop_tgt/IMPORTED_IMPLIB_CONFIG
  129. /prop_tgt/IMPORTED_IMPLIB
  130. /prop_tgt/IMPORTED_LINK_DEPENDENT_LIBRARIES_CONFIG
  131. /prop_tgt/IMPORTED_LINK_DEPENDENT_LIBRARIES
  132. /prop_tgt/IMPORTED_LINK_INTERFACE_LANGUAGES_CONFIG
  133. /prop_tgt/IMPORTED_LINK_INTERFACE_LANGUAGES
  134. /prop_tgt/IMPORTED_LINK_INTERFACE_LIBRARIES_CONFIG
  135. /prop_tgt/IMPORTED_LINK_INTERFACE_LIBRARIES
  136. /prop_tgt/IMPORTED_LINK_INTERFACE_MULTIPLICITY_CONFIG
  137. /prop_tgt/IMPORTED_LINK_INTERFACE_MULTIPLICITY
  138. /prop_tgt/IMPORTED_LOCATION_CONFIG
  139. /prop_tgt/IMPORTED_LOCATION
  140. /prop_tgt/IMPORTED_NO_SONAME_CONFIG
  141. /prop_tgt/IMPORTED_NO_SONAME
  142. /prop_tgt/IMPORTED
  143. /prop_tgt/IMPORTED_SONAME_CONFIG
  144. /prop_tgt/IMPORTED_SONAME
  145. /prop_tgt/IMPORT_PREFIX
  146. /prop_tgt/IMPORT_SUFFIX
  147. /prop_tgt/INCLUDE_DIRECTORIES
  148. /prop_tgt/INSTALL_NAME_DIR
  149. /prop_tgt/INSTALL_RPATH
  150. /prop_tgt/INSTALL_RPATH_USE_LINK_PATH
  151. /prop_tgt/INTERFACE_AUTOUIC_OPTIONS
  152. /prop_tgt/INTERFACE_COMPILE_DEFINITIONS
  153. /prop_tgt/INTERFACE_COMPILE_FEATURES
  154. /prop_tgt/INTERFACE_COMPILE_OPTIONS
  155. /prop_tgt/INTERFACE_INCLUDE_DIRECTORIES
  156. /prop_tgt/INTERFACE_LINK_LIBRARIES
  157. /prop_tgt/INTERFACE_POSITION_INDEPENDENT_CODE
  158. /prop_tgt/INTERFACE_SOURCES
  159. /prop_tgt/INTERFACE_SYSTEM_INCLUDE_DIRECTORIES
  160. /prop_tgt/INTERPROCEDURAL_OPTIMIZATION_CONFIG
  161. /prop_tgt/INTERPROCEDURAL_OPTIMIZATION
  162. /prop_tgt/JOB_POOL_COMPILE
  163. /prop_tgt/JOB_POOL_LINK
  164. /prop_tgt/LABELS
  165. /prop_tgt/LANG_COMPILER_LAUNCHER
  166. /prop_tgt/LANG_INCLUDE_WHAT_YOU_USE
  167. /prop_tgt/LANG_VISIBILITY_PRESET
  168. /prop_tgt/LIBRARY_OUTPUT_DIRECTORY_CONFIG
  169. /prop_tgt/LIBRARY_OUTPUT_DIRECTORY
  170. /prop_tgt/LIBRARY_OUTPUT_NAME_CONFIG
  171. /prop_tgt/LIBRARY_OUTPUT_NAME
  172. /prop_tgt/LINK_DEPENDS_NO_SHARED
  173. /prop_tgt/LINK_DEPENDS
  174. /prop_tgt/LINKER_LANGUAGE
  175. /prop_tgt/LINK_FLAGS_CONFIG
  176. /prop_tgt/LINK_FLAGS
  177. /prop_tgt/LINK_INTERFACE_LIBRARIES_CONFIG
  178. /prop_tgt/LINK_INTERFACE_LIBRARIES
  179. /prop_tgt/LINK_INTERFACE_MULTIPLICITY_CONFIG
  180. /prop_tgt/LINK_INTERFACE_MULTIPLICITY
  181. /prop_tgt/LINK_LIBRARIES
  182. /prop_tgt/LINK_SEARCH_END_STATIC
  183. /prop_tgt/LINK_SEARCH_START_STATIC
  184. /prop_tgt/LOCATION_CONFIG
  185. /prop_tgt/LOCATION
  186. /prop_tgt/MACOSX_BUNDLE_INFO_PLIST
  187. /prop_tgt/MACOSX_BUNDLE
  188. /prop_tgt/MACOSX_FRAMEWORK_INFO_PLIST
  189. /prop_tgt/MACOSX_RPATH
  190. /prop_tgt/MAP_IMPORTED_CONFIG_CONFIG
  191. /prop_tgt/NAME
  192. /prop_tgt/NO_SONAME
  193. /prop_tgt/NO_SYSTEM_FROM_IMPORTED
  194. /prop_tgt/OSX_ARCHITECTURES_CONFIG
  195. /prop_tgt/OSX_ARCHITECTURES
  196. /prop_tgt/OUTPUT_NAME_CONFIG
  197. /prop_tgt/OUTPUT_NAME
  198. /prop_tgt/PDB_NAME_CONFIG
  199. /prop_tgt/PDB_NAME
  200. /prop_tgt/PDB_OUTPUT_DIRECTORY_CONFIG
  201. /prop_tgt/PDB_OUTPUT_DIRECTORY
  202. /prop_tgt/POSITION_INDEPENDENT_CODE
  203. /prop_tgt/PREFIX
  204. /prop_tgt/PRIVATE_HEADER
  205. /prop_tgt/PROJECT_LABEL
  206. /prop_tgt/PUBLIC_HEADER
  207. /prop_tgt/RESOURCE
  208. /prop_tgt/RULE_LAUNCH_COMPILE
  209. /prop_tgt/RULE_LAUNCH_CUSTOM
  210. /prop_tgt/RULE_LAUNCH_LINK
  211. /prop_tgt/RUNTIME_OUTPUT_DIRECTORY_CONFIG
  212. /prop_tgt/RUNTIME_OUTPUT_DIRECTORY
  213. /prop_tgt/RUNTIME_OUTPUT_NAME_CONFIG
  214. /prop_tgt/RUNTIME_OUTPUT_NAME
  215. /prop_tgt/SKIP_BUILD_RPATH
  216. /prop_tgt/SOURCES
  217. /prop_tgt/SOVERSION
  218. /prop_tgt/STATIC_LIBRARY_FLAGS_CONFIG
  219. /prop_tgt/STATIC_LIBRARY_FLAGS
  220. /prop_tgt/SUFFIX
  221. /prop_tgt/TYPE
  222. /prop_tgt/VERSION
  223. /prop_tgt/VISIBILITY_INLINES_HIDDEN
  224. /prop_tgt/VS_DOTNET_REFERENCES
  225. /prop_tgt/VS_DOTNET_TARGET_FRAMEWORK_VERSION
  226. /prop_tgt/VS_GLOBAL_KEYWORD
  227. /prop_tgt/VS_GLOBAL_PROJECT_TYPES
  228. /prop_tgt/VS_GLOBAL_ROOTNAMESPACE
  229. /prop_tgt/VS_GLOBAL_variable
  230. /prop_tgt/VS_KEYWORD
  231. /prop_tgt/VS_SCC_AUXPATH
  232. /prop_tgt/VS_SCC_LOCALPATH
  233. /prop_tgt/VS_SCC_PROJECTNAME
  234. /prop_tgt/VS_SCC_PROVIDER
  235. /prop_tgt/VS_WINRT_COMPONENT
  236. /prop_tgt/VS_WINRT_EXTENSIONS
  237. /prop_tgt/VS_WINRT_REFERENCES
  238. /prop_tgt/WIN32_EXECUTABLE
  239. /prop_tgt/WINDOWS_EXPORT_ALL_SYMBOLS
  240. /prop_tgt/XCODE_ATTRIBUTE_an-attribute
  241. /prop_tgt/XCTEST
  242. .. _`Test Properties`:
  243. Properties on Tests
  244. ===================
  245. .. toctree::
  246. :maxdepth: 1
  247. /prop_test/ATTACHED_FILES_ON_FAIL
  248. /prop_test/ATTACHED_FILES
  249. /prop_test/COST
  250. /prop_test/DEPENDS
  251. /prop_test/ENVIRONMENT
  252. /prop_test/FAIL_REGULAR_EXPRESSION
  253. /prop_test/LABELS
  254. /prop_test/MEASUREMENT
  255. /prop_test/PASS_REGULAR_EXPRESSION
  256. /prop_test/PROCESSORS
  257. /prop_test/REQUIRED_FILES
  258. /prop_test/RESOURCE_LOCK
  259. /prop_test/RUN_SERIAL
  260. /prop_test/SKIP_RETURN_CODE
  261. /prop_test/TIMEOUT
  262. /prop_test/WILL_FAIL
  263. /prop_test/WORKING_DIRECTORY
  264. .. _`Source File Properties`:
  265. Properties on Source Files
  266. ==========================
  267. .. toctree::
  268. :maxdepth: 1
  269. /prop_sf/ABSTRACT
  270. /prop_sf/AUTOUIC_OPTIONS
  271. /prop_sf/AUTORCC_OPTIONS
  272. /prop_sf/COMPILE_DEFINITIONS
  273. /prop_sf/COMPILE_FLAGS
  274. /prop_sf/EXTERNAL_OBJECT
  275. /prop_sf/Fortran_FORMAT
  276. /prop_sf/GENERATED
  277. /prop_sf/HEADER_FILE_ONLY
  278. /prop_sf/KEEP_EXTENSION
  279. /prop_sf/LABELS
  280. /prop_sf/LANGUAGE
  281. /prop_sf/LOCATION
  282. /prop_sf/MACOSX_PACKAGE_LOCATION
  283. /prop_sf/OBJECT_DEPENDS
  284. /prop_sf/OBJECT_OUTPUTS
  285. /prop_sf/SYMBOLIC
  286. /prop_sf/VS_DEPLOYMENT_CONTENT
  287. /prop_sf/VS_DEPLOYMENT_LOCATION
  288. /prop_sf/VS_SHADER_ENTRYPOINT
  289. /prop_sf/VS_SHADER_FLAGS
  290. /prop_sf/VS_SHADER_MODEL
  291. /prop_sf/VS_SHADER_TYPE
  292. /prop_sf/VS_XAML_TYPE
  293. /prop_sf/WRAP_EXCLUDE
  294. /prop_sf/XCODE_EXPLICIT_FILE_TYPE
  295. /prop_sf/XCODE_LAST_KNOWN_FILE_TYPE
  296. .. _`Cache Entry Properties`:
  297. Properties on Cache Entries
  298. ===========================
  299. .. toctree::
  300. :maxdepth: 1
  301. /prop_cache/ADVANCED
  302. /prop_cache/HELPSTRING
  303. /prop_cache/MODIFIED
  304. /prop_cache/STRINGS
  305. /prop_cache/TYPE
  306. /prop_cache/VALUE
  307. .. _`Installed File Properties`:
  308. Properties on Installed Files
  309. =============================
  310. .. toctree::
  311. :maxdepth: 1
  312. /prop_inst/CPACK_DESKTOP_SHORTCUTS.rst
  313. /prop_inst/CPACK_NEVER_OVERWRITE.rst
  314. /prop_inst/CPACK_PERMANENT.rst
  315. /prop_inst/CPACK_START_MENU_SHORTCUTS.rst
  316. /prop_inst/CPACK_STARTUP_SHORTCUTS.rst
  317. /prop_inst/CPACK_WIX_ACL.rst
  318. Deprecated Properties on Directories
  319. ====================================
  320. .. toctree::
  321. :maxdepth: 1
  322. /prop_dir/COMPILE_DEFINITIONS_CONFIG
  323. Deprecated Properties on Targets
  324. ================================
  325. .. toctree::
  326. :maxdepth: 1
  327. /prop_tgt/COMPILE_DEFINITIONS_CONFIG
  328. /prop_tgt/POST_INSTALL_SCRIPT
  329. /prop_tgt/PRE_INSTALL_SCRIPT
  330. Deprecated Properties on Source Files
  331. =====================================
  332. .. toctree::
  333. :maxdepth: 1
  334. /prop_sf/COMPILE_DEFINITIONS_CONFIG