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)