cmake-properties.7.rst 12 KB

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