CMP0083

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

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

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

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

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

Эта политика была введена в версию CMake 3.14. Используйте команду cmake_policy() для явного задания значения OLD или NEW. В отличие от большинства политик, CMake версии 3.14.7 не предупреждает, если эта политика не установлена, и просто использует поведение OLD.

Примеры

Ведите себя как 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)