|
|
|
|
CMP0095
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
.. versionadded:: 3.16
|
|
|
|
|
|
|
|
|
|
``RPATH`` entries are properly escaped in the intermediary CMake install script.
|
|
|
|
|
|
|
|
|
|
In CMake 3.15 and earlier, ``RPATH`` entries set via
|
|
|
|
|
:variable:`CMAKE_INSTALL_RPATH` or via :prop_tgt:`INSTALL_RPATH` have not been
|
|
|
|
|
escaped before being inserted into the ``cmake_install.cmake`` script. Dynamic
|
|
|
|
|
linkers on ELF-based systems (e.g. Linux and FreeBSD) allow certain keywords in
|
|
|
|
|
``RPATH`` entries, such as ``${ORIGIN}`` (More details are available in the
|
|
|
|
|
``ld.so`` man pages on those systems). The syntax of these keywords can match
|
|
|
|
|
CMake's variable syntax. In order to not be substituted (usually to an empty
|
|
|
|
|
string) already by the intermediary ``cmake_install.cmake`` script, the user had
|
|
|
|
|
to double-escape such ``RPATH`` keywords, e.g.
|
|
|
|
|
``set(CMAKE_INSTALL_RPATH "\\\${ORIGIN}/../lib")``. Since the intermediary
|
|
|
|
|
``cmake_install.cmake`` script is an implementation detail of CMake, CMake 3.16
|
|
|
|
|
and later will make sure ``RPATH`` entries are inserted literally by escaping
|
|
|
|
|
any coincidental CMake syntax.
|
|
|
|
|
|
|
|
|
|
The ``OLD`` behavior of this policy is to not escape ``RPATH`` entries in the
|
|
|
|
|
intermediary ``cmake_install.cmake`` script. The ``NEW`` behavior is to properly
|
|
|
|
|
escape coincidental CMake syntax in ``RPATH`` entries when generating the
|
|
|
|
|
intermediary ``cmake_install.cmake`` script.
|
|
|
|
|
|
|
|
|
|
This policy was introduced in CMake version 3.16. CMake version |release| warns
|
|
|
|
|
when the policy is not set and detected usage of CMake-like syntax and uses
|
|
|
|
|
``OLD`` behavior. Use the :command:`cmake_policy` command to set it to ``OLD``
|
|
|
|
|
or ``NEW`` explicitly.
|
|
|
|
|
|
|
|
|
|
.. include:: DEPRECATED.txt
|
