Spec-Zone.ru › CMake 3.29

CheckPIESupported

Новое в версии 3.14.

Проверьте, поддерживает ли компоновщик код с независимой позицией (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()

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.29/module/CheckPIESupported.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API