Spec-Zone.ru › CMake 3.18

CMP0083

Для управления генерацией исполняемого файла с независимым от позиции (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() для явного задания значения OLD или NEW. В отличие от большинства политик, CMake версии 3.18.4 не предупреждает, когда эта политика не установлена, и просто использует поведение 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–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.18/policy/CMP0083.html

Spec-Zone.ru

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