diff options
Diffstat (limited to 'Help/cpack_gen/deb.rst')
| -rw-r--r-- | Help/cpack_gen/deb.rst | 111 |
1 files changed, 100 insertions, 11 deletions
diff --git a/Help/cpack_gen/deb.rst b/Help/cpack_gen/deb.rst index bf50c55..7cae613 100644 --- a/Help/cpack_gen/deb.rst +++ b/Help/cpack_gen/deb.rst @@ -54,11 +54,16 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_NAME` suffixed with -<COMPONENT> for component-based installations. + .. versionadded:: 3.5 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_NAME`` variables. + See https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Source .. variable:: CPACK_DEBIAN_FILE_NAME CPACK_DEBIAN_<COMPONENT>_FILE_NAME + .. versionadded:: 3.6 + Package file name. * Mandatory : YES @@ -72,6 +77,9 @@ List of CPack DEB generator specific variables: Alternatively provided package file name must end with either ``.deb`` or ``.ipk`` suffix. + .. versionadded:: 3.10 + ``.ipk`` suffix used by OPKG packaging system. + .. note:: Preferred setting of this variable is ``DEB-DEFAULT`` but for backward @@ -86,6 +94,8 @@ List of CPack DEB generator specific variables: .. variable:: CPACK_DEBIAN_PACKAGE_EPOCH + .. versionadded:: 3.10 + The Debian package epoch * Mandatory : No @@ -116,6 +126,8 @@ List of CPack DEB generator specific variables: .. variable:: CPACK_DEBIAN_PACKAGE_RELEASE + .. versionadded:: 3.6 + The Debian package release - Debian revision number. * Mandatory : No @@ -136,6 +148,9 @@ List of CPack DEB generator specific variables: * Default : Output of ``dpkg --print-architecture`` (or ``i386`` if ``dpkg`` is not found) + .. versionadded:: 3.6 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_ARCHITECTURE`` variables. + .. variable:: CPACK_DEBIAN_PACKAGE_DEPENDS CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS @@ -148,6 +163,10 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_DEPENDS` for component-based installations. + + .. versionadded:: 3.3 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS`` variables. + .. note:: If :variable:`CPACK_DEBIAN_PACKAGE_SHLIBDEPS` or @@ -165,7 +184,9 @@ List of CPack DEB generator specific variables: .. variable:: CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS - Sets inter component dependencies if listed with + .. versionadded:: 3.6 + + Sets inter-component dependencies if listed with :variable:`CPACK_COMPONENT_<compName>_DEPENDS` variables. * Mandatory : NO @@ -196,6 +217,15 @@ List of CPack DEB generator specific variables: used if set. Otherwise, :variable:`CPACK_PACKAGE_DESCRIPTION_SUMMARY` will be added as the first line of description as defined in `Debian Policy Manual`_. + .. versionadded:: 3.3 + Per-component ``CPACK_COMPONENT_<compName>_DESCRIPTION`` variables. + + .. versionadded:: 3.16 + Per-component ``CPACK_DEBIAN_<COMPONENT>_DESCRIPTION`` variables. + + .. versionadded:: 3.16 + The ``CPACK_PACKAGE_DESCRIPTION_FILE`` variable. + .. _Debian Policy Manual: https://www.debian.org/doc/debian-policy/ch-controlfields.html#description .. variable:: CPACK_DEBIAN_PACKAGE_SECTION @@ -206,10 +236,17 @@ List of CPack DEB generator specific variables: * Mandatory : YES * Default : "devel" + .. versionadded:: 3.5 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_SECTION`` variables. + See https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections .. variable:: CPACK_DEBIAN_ARCHIVE_TYPE + .. versionadded:: 3.7 + + .. deprecated:: 3.14 + The archive format used for creating the Debian package. * Mandatory : YES @@ -228,6 +265,8 @@ List of CPack DEB generator specific variables: .. variable:: CPACK_DEBIAN_COMPRESSION_TYPE + .. versionadded:: 3.1 + The compression used for creating the Debian package. * Mandatory : YES @@ -249,6 +288,9 @@ List of CPack DEB generator specific variables: * Mandatory : YES * Default : "optional" + .. versionadded:: 3.5 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_PRIORITY`` varables. + See https://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities .. variable:: CPACK_DEBIAN_PACKAGE_HOMEPAGE @@ -260,6 +302,9 @@ List of CPack DEB generator specific variables: * Mandatory : NO * Default : :variable:`CMAKE_PROJECT_HOMEPAGE_URL` + .. versionadded:: 3.12 + The ``CMAKE_PROJECT_HOMEPAGE_URL`` variable. + .. note:: The content of this field is a simple URL without any surrounding @@ -284,6 +329,12 @@ 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 + .. 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_DEBUG May be set when invoking cpack in order to trace debug information @@ -308,6 +359,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_PREDEPENDS` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_PREDEPENDS`` variables. + See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps .. variable:: CPACK_DEBIAN_PACKAGE_ENHANCES @@ -325,6 +379,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_ENHANCES` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_ENHANCES`` variables. + See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps .. variable:: CPACK_DEBIAN_PACKAGE_BREAKS @@ -345,6 +402,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_BREAKS` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_BREAKS`` variables. + See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-breaks .. variable:: CPACK_DEBIAN_PACKAGE_CONFLICTS @@ -362,6 +422,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_CONFLICTS` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS`` variables. + See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-conflicts .. note:: @@ -386,6 +449,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_PROVIDES` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_PROVIDES`` variables. + See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-virtual .. variable:: CPACK_DEBIAN_PACKAGE_REPLACES @@ -402,6 +468,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_REPLACES` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES`` variables. + See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps .. variable:: CPACK_DEBIAN_PACKAGE_RECOMMENDS @@ -418,6 +487,9 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_RECOMMENDS` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS`` variables. + See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps .. variable:: CPACK_DEBIAN_PACKAGE_SUGGESTS @@ -433,10 +505,15 @@ List of CPack DEB generator specific variables: - :variable:`CPACK_DEBIAN_PACKAGE_SUGGESTS` for component-based installations. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS`` variables. + See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps .. variable:: CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS + .. versionadded:: 3.6 + * Mandatory : NO * Default : OFF @@ -451,6 +528,8 @@ List of CPack DEB generator specific variables: .. variable:: CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY + .. versionadded:: 3.6 + Compatibility policy for auto-generated shlibs control file. * Mandatory : NO @@ -476,17 +555,14 @@ List of CPack DEB generator specific variables: set(CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA "${CMAKE_CURRENT_SOURCE_DIR}/prerm;${CMAKE_CURRENT_SOURCE_DIR}/postrm") - .. note:: - - The original permissions of the files will be used in the final - package unless the variable - :variable:`CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION` is set. - In particular, the scripts should have the proper executable - flag prior to the generation of the package. + .. versionadded:: 3.4 + Per-component ``CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONTROL_EXTRA`` variables. .. variable:: CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONTROL_STRICT_PERMISSION + .. versionadded:: 3.4 + This variable indicates if the Debian policy on control files should be strictly followed. @@ -497,15 +573,22 @@ List of CPack DEB generator specific variables: set(CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION TRUE) + This overrides the permissions on the original files, following the rules + set by Debian policy + https://www.debian.org/doc/debian-policy/ch-files.html#s-permissions-owners + .. note:: - This overrides the permissions on the original files, following the rules - set by Debian policy - https://www.debian.org/doc/debian-policy/ch-files.html#s-permissions-owners + The original permissions of the files will be used in the final + package unless this variable is set to ``TRUE``. + In particular, the scripts should have the proper executable + flag prior to the generation of the package. .. variable:: CPACK_DEBIAN_PACKAGE_SOURCE CPACK_DEBIAN_<COMPONENT>_PACKAGE_SOURCE + .. versionadded:: 3.5 + Sets the ``Source`` field of the binary Debian package. When the binary package name is not the same as the source package name (in particular when several components/binaries are generated from one @@ -529,6 +612,8 @@ List of CPack DEB generator specific variables: Packaging of debug information ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +.. versionadded:: 3.13 + Dbgsym packages contain debug symbols for debugging packaged binaries. Dbgsym packaging has its own set of variables: @@ -549,6 +634,8 @@ Dbgsym packaging has its own set of variables: Building Debian packages on Windows ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +.. versionadded:: 3.10 + To communicate UNIX file permissions from the install stage to the CPack DEB generator the "cmake_mode_t" NTFS alternate data stream (ADT) is used. @@ -559,6 +646,8 @@ permissions can be preserved. Reproducible packages ^^^^^^^^^^^^^^^^^^^^^ +.. versionadded:: 3.13 + The environment variable ``SOURCE_DATE_EPOCH`` may be set to a UNIX timestamp, defined as the number of seconds, excluding leap seconds, since 01 Jan 1970 00:00:00 UTC. If set, the CPack DEB generator will |