# INSTALL_RPATH

The rpath to use for installed targets.

By default, the install rpath is empty. It can be set using this property, which is a semicolon-separated list specifying the rpath to use in installed targets (for platforms that support it). This property is initialized by the value of the variable `CMAKE_INSTALL_RPATH` if it is set when a target is created. Beside setting the install rpath manually, using the `INSTALL_RPATH_USE_LINK_PATH` target property it can also be generated automatically by CMake.

Normally CMake uses the build tree for the RPATH when building executables etc on systems that use RPATH, see the `BUILD_RPATH` target property. When the software is installed the targets are edited (or relinked) by CMake (see `CMAKE_NO_BUILTIN_CHRPATH`) to have the install RPATH. This editing during installation can be avoided via the `BUILD_WITH_INSTALL_RPATH` target property.

For handling toolchain-dependent RPATH entries the `INSTALL_REMOVE_ENVIRONMENT_RPATH` can be used. Runtime paths can be disabled completely via the `CMAKE_SKIP_RPATH` variable.

Because the rpath may contain `${ORIGIN}`, which coincides with CMake syntax, the contents of `INSTALL_RPATH` are properly escaped in the `cmake_install.cmake` script (see policy `CMP0095`.)

This property supports `generator expressions`.

On Apple platforms, refer to the `INSTALL_NAME_DIR` target property. Under Windows, the `TARGET_RUNTIME_DLLS` generator expression is related.