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