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() или cmake_minimum_required(). Если она не установлена, CMake не выводит предупреждение и использует поведение 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)