You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
37 lines
1.4 KiB
37 lines
1.4 KiB
BUILD_RPATH
|
|
-----------
|
|
|
|
.. versionadded:: 3.8
|
|
|
|
A :ref:`semicolon-separated list <CMake Language Lists>` specifying
|
|
runtime path (``RPATH``) entries to add to binaries linked in the
|
|
build tree (for platforms that support it). By default, CMake sets
|
|
the runtime path of binaries in the build tree to contain search
|
|
paths it knows are needed to find the shared libraries they link.
|
|
Projects may set ``BUILD_RPATH`` to specify additional search paths.
|
|
|
|
The build-tree runtime path will *not* be used for binaries in the
|
|
install tree. It will be replaced with the install-tree runtime path
|
|
during the installation step. See also the :prop_tgt:`INSTALL_RPATH`
|
|
target property.
|
|
|
|
This property is initialized by the value of the variable
|
|
:variable:`CMAKE_BUILD_RPATH` if it is set when a target is created.
|
|
|
|
This property supports
|
|
:manual:`generator expressions <cmake-generator-expressions(7)>`.
|
|
|
|
Other settings that affect the build-tree runtime path include:
|
|
|
|
* The :variable:`CMAKE_SKIP_RPATH` variable completely disables runtime
|
|
paths in both the build tree and install tree.
|
|
|
|
* The :prop_tgt:`SKIP_BUILD_RPATH` target property disables setting any
|
|
runtime path in the build tree.
|
|
|
|
* The :prop_tgt:`BUILD_RPATH_USE_ORIGIN` target property causes the
|
|
automatically-generated runtime path to use entries relative to ``$ORIGIN``.
|
|
|
|
* The :prop_tgt:`BUILD_WITH_INSTALL_RPATH` target property causes binaries
|
|
in the build tree to be built with the install-tree runtime path.
|