Spec-Zone.ru › CMake 3.29

CMP0083

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

Для управления генерацией исполняемого файла с независимой позицией (PIE) или без неё, требуются некоторые флаги на этапе линковки.

CMake 3.13 и ниже не добавляли эти флаги линковки, когда POSITION_INDEPENDENT_CODE был установлен.

Поведение OLD по этому политике — не управлять PIE флагами линковки. Поведение NEW — добавить флаги линковки, если POSITION_INDEPENDENT_CODE установлен:

  • Установлено TRUE: флаги для создания исполняемого файла с независимой позицией передаются шагу линковки. Например, -pie для GCC.
  • Установлено FALSE: флаги для не создания исполняемого файла с независимой позицией передаются шагу линковки. Например, -no-pie для GCC.
  • Не установлен: никакие флаги не передаются шагу линковки.

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

Этот политику был введен в CMake версии 3.14. Его можно установить с помощью cmake_policy() или cmake_minimum_required(). Если он не установлен, CMake не выводит предупреждение и использует поведение OLD.

Примечание

Платформа Android имеет специальную обработку PIE, поэтому нет необходимости использовать модуль CheckPIESupported для обеспечения передачи флагов линковщику.

Примечание

Поведение OLD политики deprecated by definition и может быть удалено в будущей версии CMake.

Примеры

Ведите себя как CMake 3.13 и не применяйте PIE флаги на этапе линковки.

cmake_minimum_required(VERSION 3.13)
project(foo)

# ...

add_executable(foo ...)
set_property(TARGET foo PROPERTY POSITION_INDEPENDENT_CODE TRUE)

Используйте модуль CheckPIESupported, чтобы определить, поддерживает ли текущий линковщик и среда PIE. Применяйте PIE флаги только в том случае, если линковщик их поддерживает.

cmake_minimum_required(VERSION 3.14) # CMP0083 NEW
project(foo)

include(CheckPIESupported)
check_pie_supported()

# ...

add_executable(foo ...)
set_property(TARGET foo PROPERTY POSITION_INDEPENDENT_CODE TRUE)

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

Spec-Zone.ru

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