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)