CheckPIESupported

Проверяет, поддерживает ли компоновщик независимый от позиции код (PIE) или код без независимости от позиции (NO_PIE) для исполняемых файлов. Это используется для обеспечения того, что свойство цели POSITION_INDEPENDENT_CODE для исполняемых файлов будет учтено во время компоновки.

check_pie_supported

check_pie_supported([OUTPUT_VARIABLE <output>]
                    [LANGUAGES <lang>...])

Варианты:

OUTPUT_VARIABLE <output>

Устанавливает переменную <output> с деталями об ошибке. Если проверка пропущена из-за использования кэшированных результатов предыдущего вызова, вывод будет пустым, даже если в предыдущем вызове были ошибки.

LANGUAGES <lang>...

Проверяет компоновщики, используемые для каждого указанного языка. Если этот параметр не указан, команда проверяет все включенные языки.

Поддерживаются C, CXX, и Fortran.

Добавлен в версии 3.23: OBJC, OBJCXX, CUDA, и HIP поддерживаются.

Использование этого модуля бессмысленно, когда CMP0083 установлено в OLD, поэтому в этом случае команда вернёт ошибку. См. политику CMP0083 для подробностей.

Переменные

Для каждого проверенного языка определяются две булевы переменные кэша.

CMAKE_<lang>_LINK_PIE_SUPPORTED

Устанавливается в true, если PIE поддерживается компоновщиком, и в false в противном случае.

CMAKE_<lang>_LINK_NO_PIE_SUPPORTED

Устанавливается в true, если NO_PIE поддерживается компоновщиком, и в false в противном случае.

Примеры

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()