mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-08-02 11:02:46 +08:00
496ec6036f
Run the `Utilities/Sphinx/update_versions.py` script to add initial markup to every top-level document and find module. Issue: #19715
27 lines
1.1 KiB
ReStructuredText
27 lines
1.1 KiB
ReStructuredText
BUILD_RPATH_USE_ORIGIN
|
|
----------------------
|
|
|
|
.. versionadded:: 3.14
|
|
|
|
Whether to use relative paths for the build ``RPATH``.
|
|
|
|
This property is initialized by the value of the variable
|
|
:variable:`CMAKE_BUILD_RPATH_USE_ORIGIN`.
|
|
|
|
On platforms that support runtime paths (``RPATH``) with the
|
|
``$ORIGIN`` token, setting this property to ``TRUE`` enables relative
|
|
paths in the build ``RPATH`` for executables and shared libraries that
|
|
point to shared libraries in the same build tree.
|
|
|
|
Normally the build ``RPATH`` of a binary contains absolute paths
|
|
to the directory of each shared library it links to. The ``RPATH``
|
|
entries for directories contained within the build tree can be made
|
|
relative to enable relocatable builds and to help achieve reproducible
|
|
builds by omitting the build directory from the build environment.
|
|
|
|
This property has no effect on platforms that do not support the
|
|
``$ORIGIN`` token in ``RPATH``, or when the :variable:`CMAKE_SKIP_RPATH`
|
|
variable is set. The runtime path set through the
|
|
:prop_tgt:`BUILD_RPATH` target property is also unaffected by this
|
|
property.
|