summaryrefslogtreecommitdiffstats
path: root/Help/cpack_gen/deb.rst
diff options
context:
space:
mode:
authorDeniz Bahadir <dbahadir@benocs.com>2021-01-19 13:09:46 (GMT)
committerBrad King <brad.king@kitware.com>2021-01-22 13:33:01 (GMT)
commitd586a4ad60f34a14c202a3dd60dbfbf50d69ca7f (patch)
tree3e6619f6619955b83f501d9412b8e08f34c7635c /Help/cpack_gen/deb.rst
parent2740cc458b858bf0dedec718b0f089694f87cbd4 (diff)
downloadCMake-d586a4ad60f34a14c202a3dd60dbfbf50d69ca7f.zip
CMake-d586a4ad60f34a14c202a3dd60dbfbf50d69ca7f.tar.gz
CMake-d586a4ad60f34a14c202a3dd60dbfbf50d69ca7f.tar.bz2
CPackDeb: dpkg-shlibdeps now supports searching for private shared libs
The new CPack variable `CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS` can be set to a list of directories. If `CPACK_DEBIAN_PACKAGE_SHLIBDEPS` or `CPACK_DEBIAN_<component>_PACKAGE_SHLIBDEPS` are set to `ON` these directories will be searched by `dpkg-shlibdeps` in order to find private shared library dependencies of the libraries/executables that shall be packed.
Diffstat (limited to 'Help/cpack_gen/deb.rst')
-rw-r--r--Help/cpack_gen/deb.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/Help/cpack_gen/deb.rst b/Help/cpack_gen/deb.rst
index 7cae613..42b8392 100644
--- a/Help/cpack_gen/deb.rst
+++ b/Help/cpack_gen/deb.rst
@@ -329,12 +329,36 @@ List of CPack DEB generator specific variables:
may fail to find your own shared libs.
See https://gitlab.kitware.com/cmake/community/-/wikis/doc/cmake/RPATH-handling
+ .. note::
+
+ You can also set :variable:`CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS`
+ to an appropriate value if you use this feature, in order to please
+ ``dpkg-shlibdeps``. However, you should only do this for private
+ shared libraries that could not get resolved otherwise.
+
.. versionadded:: 3.3
Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_SHLIBDEPS`` variables.
.. versionadded:: 3.6
Correct handling of ``$ORIGIN`` in :variable:`CMAKE_INSTALL_RPATH`.
+.. variable:: CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS
+
+ .. versionadded:: 3.20
+
+ May be set to a list of directories that will be given to ``dpkg-shlibdeps``
+ via its ``-d`` option. These will be searched by ``dpkg-shlibdeps`` in order
+ to find private shared library dependencies.
+
+ * Mandatory : NO
+ * Default :
+
+ .. note::
+
+ You should prefer to set :variable:`CMAKE_INSTALL_RPATH` to an appropriate
+ value if you use ``dpkg-shlibdeps``. The current option is really only
+ needed for private shared library dependencies.
+
.. variable:: CPACK_DEBIAN_PACKAGE_DEBUG
May be set when invoking cpack in order to trace debug information