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