The builtin (binary) CPack Deb generator (Unix only)
CPackDeb may be used to create Deb package using CPack. CPackDeb is a CPack generator thus it uses the CPACK_XXX
variables used by CPack : https://cmake.org/Wiki/CMake:CPackConfiguration. CPackDeb generator should work on any linux host but it will produce better deb package when Debian specific tools ‘dpkg-xxx’ are usable on the build system.
CPackDeb has specific features which are controlled by the specifics CPACK_DEBIAN_XXX
variables.
CPACK_DEBIAN_<COMPONENT>_XXXX
variables may be used in order to have component specific values. Note however that <COMPONENT>
refers to the grouping name written in upper case. It may be either a component name or a component GROUP name.
You’ll find a detailed usage on the wiki: https://cmake.org/Wiki/CMake:CPackPackageGenerators#DEB_.28UNIX_only.29 . However as a handy reminder here comes the list of specific variables:
CPACK_DEBIAN_PACKAGE_NAME
CPACK_DEBIAN__PACKAGE_NAME
Set Package control field (variable is automatically transformed to lower case).
CPACK_PACKAGE_NAME
for non-component based installationsCPACK_DEBIAN_PACKAGE_NAME
suffixed with -<COMPONENT> for component-based installations.See https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Source
CPACK_DEBIAN_PACKAGE_VERSION
The Debian package version
CPACK_PACKAGE_VERSION
CPACK_DEBIAN_PACKAGE_ARCHITECTURE
The Debian package architecture
dpkg --print-architecture
(or i386
if dpkg
is not found)CPACK_DEBIAN_PACKAGE_DEPENDS
CPACK_DEBIAN__PACKAGE_DEPENDS
Sets the Debian dependencies of this package.
CPACK_DEBIAN_PACKAGE_DEPENDS
for component-based installations.Note
If CPACK_DEBIAN_PACKAGE_SHLIBDEPS
or more specifically CPACK_DEBIAN_<COMPONENT>_PACKAGE_SHLIBDEPS
is set for this component, the discovered dependencies will be appended to CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS
instead of CPACK_DEBIAN_PACKAGE_DEPENDS
. If CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS
is an empty string, only the automatically discovered dependencies will be set for this component.
Example:
set(CPACK_DEBIAN_PACKAGE_DEPENDS "libc6 (>= 2.3.1-6), libc6 (< 2.4)")
CPACK_DEBIAN_PACKAGE_MAINTAINER
The Debian package maintainer
CPACK_PACKAGE_CONTACT
CPACK_DEBIAN_PACKAGE_DESCRIPTION
CPACK_COMPONENT__DESCRIPTION
The Debian package description
CPACK_DEBIAN_PACKAGE_SECTION
CPACK_DEBIAN__PACKAGE_SECTION
Set Section control field e.g. admin, devel, doc, ...
See https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections
CPACK_DEBIAN_COMPRESSION_TYPE
The compression used for creating the Debian package. Possible values are: lzma, xz, bzip2 and gzip.
CPACK_DEBIAN_PACKAGE_PRIORITY
CPACK_DEBIAN__PACKAGE_PRIORITY
Set Priority control field e.g. required, important, standard, optional, extra
See https://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities
CPACK_DEBIAN_PACKAGE_HOMEPAGE
The URL of the web site for this package, preferably (when applicable) the site from which the original source can be obtained and any additional upstream documentation or information may be found.
Note
The content of this field is a simple URL without any surrounding characters such as <>.
CPACK_DEBIAN_PACKAGE_SHLIBDEPS
CPACK_DEBIAN__PACKAGE_SHLIBDEPS
May be set to ON in order to use dpkg-shlibdeps
to generate better package dependency list.
CPACK_DEBIAN_PACKAGE_SHLIBDEPS
if set orNote
You may need set CMAKE_INSTALL_RPATH
to an appropriate value if you use this feature, because if you don’t dpkg-shlibdeps
may fail to find your own shared libs. See https://cmake.org/Wiki/CMake_RPATH_handling.
CPACK_DEBIAN_PACKAGE_DEBUG
May be set when invoking cpack in order to trace debug information during CPackDeb run.
CPACK_DEBIAN_PACKAGE_PREDEPENDS
CPACK_DEBIAN__PACKAGE_PREDEPENDS
Sets the Pre-Depends field of the Debian package. Like Depends
, except that it also forces dpkg
to complete installation of the packages named before even starting the installation of the package which declares the pre-dependency.
CPACK_DEBIAN_PACKAGE_PREDEPENDS
for component-based installations.See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
CPACK_DEBIAN_PACKAGE_ENHANCES
CPACK_DEBIAN__PACKAGE_ENHANCES
Sets the Enhances field of the Debian package. Similar to Suggests
but works in the opposite direction: declares that a package can enhance the functionality of another package.
CPACK_DEBIAN_PACKAGE_ENHANCES
for component-based installations.See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
CPACK_DEBIAN_PACKAGE_BREAKS
CPACK_DEBIAN__PACKAGE_BREAKS
Sets the Breaks field of the Debian package. When a binary package (P) declares that it breaks other packages (B), dpkg
will not allow the package (P) which declares Breaks be unpacked unless the packages that will be broken (B) are deconfigured first. As long as the package (P) is configured, the previously deconfigured packages (B) cannot be reconfigured again.
CPACK_DEBIAN_PACKAGE_BREAKS
for component-based installations.See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-breaks
CPACK_DEBIAN_PACKAGE_CONFLICTS
CPACK_DEBIAN__PACKAGE_CONFLICTS
Sets the Conflicts field of the Debian package. When one binary package declares a conflict with another using a Conflicts field, dpkg
will not allow them to be unpacked on the system at the same time.
CPACK_DEBIAN_PACKAGE_CONFLICTS
for component-based installations.See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-conflicts
Note
This is a stronger restriction than Breaks
, which prevents the broken package from being configured while the breaking package is in the “Unpacked” state but allows both packages to be unpacked at the same time.
CPACK_DEBIAN_PACKAGE_PROVIDES
CPACK_DEBIAN__PACKAGE_PROVIDES
Sets the Provides field of the Debian package. A virtual package is one which appears in the Provides control field of another package.
CPACK_DEBIAN_PACKAGE_PROVIDES
for component-based installations.See https://www.debian.org/doc/debian-policy/ch-relationships.html#s-virtual
CPACK_DEBIAN_PACKAGE_REPLACES
CPACK_DEBIAN__PACKAGE_REPLACES
Sets the Replaces field of the Debian package. Packages can declare in their control file that they should overwrite files in certain other packages, or completely replace other packages.
CPACK_DEBIAN_PACKAGE_REPLACES
for component-based installations.See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
CPACK_DEBIAN_PACKAGE_RECOMMENDS
CPACK_DEBIAN__PACKAGE_RECOMMENDS
Sets the Recommends field of the Debian package. Allows packages to declare a strong, but not absolute, dependency on other packages.
CPACK_DEBIAN_PACKAGE_RECOMMENDS
for component-based installations.See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
CPACK_DEBIAN_PACKAGE_SUGGESTS
CPACK_DEBIAN__PACKAGE_SUGGESTS
Sets the Suggests field of the Debian package. Allows packages to declare a suggested package install grouping.
CPACK_DEBIAN_PACKAGE_SUGGESTS
for component-based installations.See http://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps
CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA
CPACK_DEBIAN__PACKAGE_CONTROL_EXTRA
This variable allow advanced user to add custom script to the control.tar.gz. Typical usage is for conffiles, postinst, postrm, prerm.
Usage:
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 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.
CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION
CPACK_DEBIAN__PACKAGE_CONTROL_STRICT_PERMISSION
This variable indicates if the Debian policy on control files should be strictly followed.
Usage:
set(CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION TRUE)
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
CPACK_DEBIAN_PACKAGE_SOURCE
CPACK_DEBIAN__PACKAGE_SOURCE
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 source) the source from which the binary has been generated should be indicated with the field Source
.
CPACK_DEBIAN_PACKAGE_SOURCE
for component-based installations.See https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Source
Note
This value is not interpreted. It is possible to pass an optional revision number of the referenced source package as well.
© 2000–2016 Kitware, Inc.
© 2000–2011 Insight Software Consortium
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.5/module/CPackDeb.html