CheckLinkerFlag

Проверка поддержки компилятором заданного флага линковки.

check_linker_flag

check_linker_flag(<lang> <flag> <var>)

Проверка, что <flag> флаг линковки принимается компилятором <lang> без диагностических сообщений. Результат сохраняется во внутренней кэшированной записи с именем <var>.

Эта команда временно устанавливает переменную CMAKE_REQUIRED_LINK_OPTIONS и вызывает макрос check_<lang>_source_compiles из модуля Check<lang>SourceCompiles (CheckCSourceCompiles, CheckCSourceCompiles, CheckCXXSourceCompiles, CheckOBJCSourceCompiles, CheckOBJCXXSourceCompiles или CheckFortranSourceCompiles). См. документацию этих модулей для списка переменных, которые могут иначе изменить сборку.

В основе реализации лежит свойство LINK_OPTIONS для проверки указанного флага. Также можно использовать префикс LINKER:, как описано в команде target_link_options().

Положительный результат этой проверки означает только то, что компилятор не выдал диагностическое сообщение при предоставлении флага линковки. Влияние флага или его конкретное влияние выходит за рамки этого модуля.