CMAKE_LINK_GROUP_USING_

Эта переменная определяет, как связать группу библиотек для указанного <FEATURE> при использовании генераторного выражения LINK_GROUP. Для того, чтобы эта переменная имела какой-либо эффект, должны быть выполнены оба следующих условия:

• Соответствующая переменная CMAKE_LINK_GROUP_USING_<FEATURE>_SUPPORTED должна быть установлена в значение true.
• Нет языкоспецифичного определения для того же <FEATURE>. Это означает, что CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE>_SUPPORTED не может быть истинным для языка линковки, используемого целевым объектом, для которого оценивается генераторное выражение LINK_GROUP.

Переменная CMAKE_<LANG>_LINK_GROUP_USING_<FEATURE> должна быть определена вместо этого для функций, зависящих от языка линковки.

Имена функций чувствительны к регистру и могут содержать только буквы, цифры и символы нижнего подчеркивания. Имена функций, заданные в верхнем регистре, зарезервированы для встроенных функций CMake (см. Предопределённые функции ниже).

Определения функций

Определение функции группы — это список, содержащий ровно два элемента:

<PREFIX> <SUFFIX>

В командной строке компоновщика <PREFIX> будет предшествовать списку библиотек в группе, а <SUFFIX> будет следовать за ним.

Для элементов этой переменной можно использовать префикс LINKER:.

Для передачи параметров инструменту компоновки каждый компиляторный драйвер имеет свой собственный синтаксис. Префикс LINKER: и разделитель , могут быть использованы для указания портативно параметров, которые необходимо передать инструменту компоновки. LINKER: заменяется соответствующим параметром драйвера, а , — соответствующим разделителем драйвера. Префикс и разделитель драйвера задаются значениями переменных CMAKE_<LANG>_LINKER_WRAPPER_FLAG и CMAKE_<LANG>_LINKER_WRAPPER_FLAG_SEP.

Например, "LINKER:-z,defs" становится -Xlinker -z -Xlinker defs для Clang и -Wl,-z,defs для GNU GCC.

Префикс LINKER: может быть указан как часть выражения префикса SHELL:.

Префикс LINKER: поддерживает, как альтернативный синтаксис, указание аргументов с использованием префикса SHELL: и пробела в качестве разделителя. Предыдущий пример затем становится "LINKER:SHELL:-z defs".

Примеры

Решение перекрестных ссылок между двумя статическими библиотеками

Проект может определять две или более статические библиотеки, между которыми существуют циклические зависимости. Для того, чтобы компоновщик разрешил все символы во время компоновки, ему может потребоваться многократно искать среди библиотек, пока не будут созданы новые неопределённые ссылки. Разные компоновщики используют разные синтаксисы для достижения этого. Следующий пример демонстрирует, как это может быть реализовано для некоторых компоновщиков. Обратите внимание, что это только для целей иллюстрации. Проекты должны использовать встроенную функцию группы RESCAN (см. Предопределённые функции), которая обеспечивает более полную и надёжную реализацию этой функциональности.

set(CMAKE_C_LINK_GROUP_USING_cross_refs_SUPPORTED TRUE)
if(CMAKE_C_COMPILER_ID STREQUAL "GNU" AND CMAKE_SYSTEM_NAME STREQUAL "Linux")
  set(CMAKE_C_LINK_GROUP_USING_cross_refs
    "LINKER:--start-group"
    "LINKER:--end-group"
  )
elseif(CMAKE_C_COMPILER_ID STREQUAL "SunPro" AND CMAKE_SYSTEM_NAME STREQUAL "SunOS")
  set(CMAKE_C_LINK_GROUP_USING_cross_refs
    "LINKER:-z,rescan-start"
    "LINKER:-z,rescan-end"
  )
else()
  # feature not yet supported for the other environments
  set(CMAKE_C_LINK_GROUP_USING_cross_refs_SUPPORTED FALSE)
endif()

add_library(lib1 STATIC ...)
add_library(lib2 SHARED ...)

if(CMAKE_C_LINK_GROUP_USING_cross_refs_SUPPORTED)
  target_link_libraries(lib2 PRIVATE "$<LINK_GROUP:cross_refs,lib1,external>")
else()
  target_link_libraries(lib2 PRIVATE lib1 external)
endif()

CMake сгенерирует следующие фрагменты командной строки компоновщика при линковке lib2:

• GNU: -Wl,--start-group /path/to/lib1.a -lexternal -Wl,--end-group
• SunPro: -Wl,-z,rescan-start /path/to/lib1.a -lexternal -Wl,-z,rescan-end

Предопределённые функции

Следующие встроенные функции группы предварительно определены CMake:

RESCAN

Некоторые компоновщики поддерживают только одно проход. Для таких компоновщиков циклические ссылки между библиотеками обычно приводят к неразрешенным символам. Эта функция инструктирует компоновщик многократно искать указанные статические библиотеки, пока не будут созданы новые неопределённые ссылки.

Обычно статическая библиотека ищется только один раз в порядке, в котором она указана в командной строке. Если символ в этой библиотеке необходим для разрешения неопределённого символа, на который ссылается объект в библиотеке, появляющейся позже в командной строке, компоновщик не сможет разрешить эту ссылку. Сгруппировав статические библиотеки с функцией RESCAN, они все будут многократно просматриваться, пока не будут разрешены все возможные ссылки. Это будет использовать параметры компоновщика, такие как --start-group и --end-group, или на SunOS, -z rescan-start и -z rescan-end.

Использование этой функции имеет значительную стоимость производительности. Лучше всего использовать её только в случаях неизбежных циклических ссылок между двумя или более статическими библиотеками.

Эта функция доступна при использовании платформ, нацеленных на Linux, BSD и SunOS. Она также может быть использована при нацеливании на платформы Windows, если используется GNU компилятор.