New in version 3.14.
Whether to use relative paths for the build RPATH
.
This property is initialized by the value of the 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 CMAKE_SKIP_RPATH
variable is set. The runtime path set through the BUILD_RPATH
target property is also unaffected by this property.
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.19/prop_tgt/BUILD_RPATH_USE_ORIGIN.html