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.