| BUILD_RPATH_USE_ORIGIN |
| ---------------------- |
| |
| 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 that point to shared |
| libraries in the same build tree. |
| |
| Normally the build ``RPATH`` of an executable contains absolute paths |
| to the directory of shared libraries. Directories contained within the |
| build tree can be made relative to enable relocatable builds and to |
| help achieving 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. |