summaryrefslogtreecommitdiffstats
path: root/Help
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
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')
-rw-r--r--Help/cpack_gen/deb.rst24
-rw-r--r--Help/release/dev/cpack-deb-shlibdeps-private-search-dirs.rst8
2 files changed, 32 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
diff --git a/Help/release/dev/cpack-deb-shlibdeps-private-search-dirs.rst b/Help/release/dev/cpack-deb-shlibdeps-private-search-dirs.rst
new file mode 100644
index 0000000..c4a4797
--- /dev/null
+++ b/Help/release/dev/cpack-deb-shlibdeps-private-search-dirs.rst
@@ -0,0 +1,8 @@
+cpack-deb-shlibdeps-resolving-private-dependencies
+--------------------------------------------------
+
+* The :module:`CPackDeb` module learned a new
+ :variable:`CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS`
+ variable to specify additional search directories for
+ resolving private library dependencies when using
+ ``dpkg-shlibdeps``.