|
|
|
|
DESTDIR
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
.. include:: ENV_VAR.txt
|
|
|
|
|
|
|
|
|
|
On UNIX one can use the ``DESTDIR`` mechanism in order to relocate the
|
|
|
|
|
whole installation. ``DESTDIR`` means DESTination DIRectory. It is
|
|
|
|
|
commonly used by packagers to install software in a staging directory.
|
|
|
|
|
|
|
|
|
|
For example, running
|
|
|
|
|
|
|
|
|
|
.. code-block:: shell
|
|
|
|
|
|
|
|
|
|
make DESTDIR=/package/stage install
|
|
|
|
|
|
|
|
|
|
will install the software using the installation prefix, e.g. ``/usr/local``,
|
|
|
|
|
prepended with the ``DESTDIR`` value which gives ``/package/stage/usr/local``.
|
|
|
|
|
The packaging tool may then construct the package from the content of the
|
|
|
|
|
``/package/stage`` directory.
|
|
|
|
|
|
|
|
|
|
See the :variable:`CMAKE_INSTALL_PREFIX` variable to control the
|
|
|
|
|
installation prefix when configuring a build tree. Or, when using
|
|
|
|
|
the :manual:`cmake(1)` command-line tool's ``--install`` mode,
|
|
|
|
|
one may specify a different prefix using the ``--prefix`` option.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
``DESTDIR`` may not be used on Windows because installation
|
|
|
|
|
prefix usually contains a drive letter like in ``C:/Program Files``
|
|
|
|
|
which cannot be prepended with some other prefix.
|
