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.25.1 не предупреждает, когда эта политика не установлена, а просто использует поведение 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)