Files
CMake/Help/variable/CMAKE_LINK_SEARCH_START_STATIC.rst
Kitware Robot 496ec6036f Help: Add Sphinx 'versionadded' directives to each top-level document
Run the `Utilities/Sphinx/update_versions.py` script to add initial
markup to every top-level document and find module.

Issue: #19715
2020-07-06 10:23:20 -04:00

23 lines
950 B
ReStructuredText

CMAKE_LINK_SEARCH_START_STATIC
------------------------------
.. versionadded:: 3.4
Assume the linker looks for static libraries by default.
Some linkers support switches such as ``-Bstatic`` and ``-Bdynamic`` to
determine whether to use static or shared libraries for ``-lXXX`` options.
CMake uses these options to set the link type for libraries whose full
paths are not known or (in some cases) are in implicit link
directories for the platform. By default the linker search type is
assumed to be ``-Bdynamic`` at the beginning of the library list. This
property switches the assumption to ``-Bstatic``. It is intended for use
when linking an executable statically (e.g. with the GNU ``-static``
option).
This variable is used to initialize the target property
:prop_tgt:`LINK_SEARCH_START_STATIC` for all targets. If set, it's
value is also used by the :command:`try_compile` command.
See also :variable:`CMAKE_LINK_SEARCH_END_STATIC`.