On this page
CheckPIESupported
New in version 3.14.
Check whether the linker supports Position Independent Code (PIE) or No Position Independent Code (NO_PIE) for executables. Use this to ensure that the POSITION_INDEPENDENT_CODE
target property for executables will be honored at link time.
check_pie_supported
-
check_pie_supported([OUTPUT_VARIABLE <output>] [LANGUAGES <lang>...])
Options are:
OUTPUT_VARIABLE <output>
-
Set
<output>
variable with details about any error. LANGUAGES <lang>...
-
Check the linkers used for each of the specified languages. Supported languages are
C
,CXX
, andFortran
.
It makes no sense to use this module when CMP0083
is set to OLD
, so the command will return an error in this case. See policy CMP0083
for details.
Variables
For each language checked, two boolean cache variables are defined.
CMAKE_<lang>_LINK_PIE_SUPPORTED
-
Set to
YES
ifPIE
is supported by the linker andNO
otherwise. CMAKE_<lang>_LINK_NO_PIE_SUPPORTED
-
Set to
YES
ifNO_PIE
is supported by the linker andNO
otherwise.
Examples
check_pie_supported()
set_property(TARGET foo PROPERTY POSITION_INDEPENDENT_CODE TRUE)
# Retrieve any error message.
check_pie_supported(OUTPUT_VARIABLE output LANGUAGES C)
set_property(TARGET foo PROPERTY POSITION_INDEPENDENT_CODE TRUE)
if(NOT CMAKE_C_LINK_PIE_SUPPORTED)
message(WARNING "PIE is not supported at link time: ${output}.\n"
"PIE link options will not be passed to linker.")
endif()
© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.20/module/CheckPIESupported.html