target_link_options

Добавляет опции к шагу компоновки для исполняемого файла, динамической библиотеки или библиотеки модулей.

target_link_options(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

Именованный <target> должен быть создан командой, такой как add_executable() или add_library(), и не должен быть целью-псевдонимом.

Эта команда может быть использована для добавления любых опций компоновки, но существуют альтернативные команды для добавления библиотек (target_link_libraries() или link_libraries()). См. документацию по свойствам directory и target LINK_OPTIONS.

Если BEFORE указано, содержание будет добавлено в начало свойства, а не в конец.

Ключевые слова INTERFACE, PUBLIC и PRIVATE необходимы для указания области действия следующих аргументов. PRIVATE и PUBLIC элементы будут заполнять свойство LINK_OPTIONS <target>. PUBLIC и INTERFACE элементы будут заполнять свойство INTERFACE_LINK_OPTIONS <target>. (Импортированные цели поддерживают только INTERFACE элементы.) Следующие аргументы задают параметры компоновки. Повторные вызовы для одной и той же <target> добавляют элементы в порядке вызова.

Аргументы для target_link_options могут использовать «выражения генератора» с синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения дополнительной информации о определении свойств системы сборки.

При вовлечении шага компоновки устройства, контролируемого свойствами CUDA_SEPARABLE_COMPILATION и CUDA_RESOLVE_DEVICE_SYMBOLS и политикой CMP0105, сырые параметры будут переданы в шаги компоновки хоста и устройства (упакованные в -Xcompiler или эквивалент для компоновки устройства). Параметры, заключенные в $<DEVICE_LINK:...> generator expression, будут использоваться только для шага компоновки устройства. Параметры, заключенные в $<HOST_LINK:...> generator expression, будут использоваться только для шага компоновки хоста.

Набор параметров компиляции или компоновки, используемых для цели, формируется путем накопления параметров от текущей цели и требований к ее зависимостям. Набор параметров дублируется, чтобы избежать повторения. Хотя это полезно для отдельных параметров, шаг дублирования может разрывать группы параметров. Например, -D A -D B становится -D A B. Можно указать группу параметров, используя оболочечную запись вместе с префиксом SHELL:. Префикс SHELL: удаляется, а остальная часть строки параметров анализируется с помощью режима separate_arguments() UNIX_COMMAND. Например, "SHELL:-D A" "SHELL:-D B" становится -D A -D B.

Для передачи параметров компоновщику, у каждого драйвера компилятора есть свой собственный синтаксис. Префикс 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".