OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 archive.html	16.01 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 bundle.html	11.75 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 cygwin.html	7.64 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 deb.html	76.41 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 dmg.html	22.17 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 external.html	36.37 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 freebsd.html	21.34 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 ifw.html	52.19 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 nsis.html	27.4 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 nuget.html	37.62 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 packagemaker.html	5.7 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 productbuild.html	31.72 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 rpm.html	113.54 KB	04/04/2023 07:05:05 PM	rw-r--r--
📄 wix.html	28.02 KB	04/04/2023 07:05:05 PM	rw-r--r--

Editing: deb.html

<!DOCTYPE html>

<title>CPack DEB Generator &mdash; CMake 3.26.3 Documentation</title>

</head><body>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="dmg.html" title="CPack DragNDrop Generator"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="cygwin.html" title="CPack Cygwin Generator"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cpack-generators.7.html" accesskey="U">cpack-generators(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">CPack DEB Generator</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cpack-deb-generator">
<h1>CPack DEB Generator<a class="headerlink" href="#cpack-deb-generator" title="Permalink to this heading">¶</a></h1>
The built in (binary) CPack DEB generator (Unix only)
<section id="variables-specific-to-cpack-debian-deb-generator">
<h2>Variables specific to CPack Debian (DEB) generator<a class="headerlink" href="#variables-specific-to-cpack-debian-deb-generator" title="Permalink to this heading">¶</a></h2>
The CPack DEB generator may be used to create DEB package using <a class="reference internal" href="../module/CPack.html#module:CPack" title="CPack"><code class="xref cmake cmake-module docutils literal notranslate">CPack</code></a>.
The CPack DEB generator is a <a class="reference internal" href="../module/CPack.html#module:CPack" title="CPack"><code class="xref cmake cmake-module docutils literal notranslate">CPack</code></a> generator thus it uses the
<code class="xref cmake cmake-variable docutils literal notranslate">CPACK_XXX</code> variables used by <a class="reference internal" href="../module/CPack.html#module:CPack" title="CPack"><code class="xref cmake cmake-module docutils literal notranslate">CPack</code></a>.
The CPack DEB generator should work on any Linux host but it will produce
better deb package when Debian specific tools <code class="docutils literal notranslate">dpkg-xxx</code> are usable on
the build system.
The CPack DEB generator has specific features which are controlled by the
specifics <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_XXX</code> variables.
<code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_XXXX</code> variables may be used in order to have
component specific values. Note however that <code class="docutils literal notranslate">&lt;COMPONENT&gt;</code> refers to
the grouping name written in upper case. It may be either a component name
or a component GROUP name.
Here are some CPack DEB generator wiki resources that are here for historic
reasons and are no longer maintained but may still prove useful:
<blockquote>
<div><ul class="simple">
<li><a class="reference external" href="https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/Configuration">https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/Configuration</a></li>
<li><a class="reference external" href="https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/PackageGenerators#deb-unix-only">https://gitlab.kitware.com/cmake/community/-/wikis/doc/cpack/PackageGenerators#deb-unix-only</a></li>
</ul>
</div></blockquote>
List of CPack DEB generator specific variables:
<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEB_COMPONENT_INSTALL">
CPACK_DEB_COMPONENT_INSTALL<a class="headerlink" href="#variable:CPACK_DEB_COMPONENT_INSTALL" title="Permalink to this definition">¶</a></dt>
<dd>Enable component packaging for CPackDEB
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">OFF</code>
</dd>
</dl>
If enabled (<code class="docutils literal notranslate">ON</code>) multiple packages are generated. By default a single package
containing files of all components is generated.
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_NAME">
CPACK_DEBIAN_PACKAGE_NAME<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_NAME" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_NAME">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_NAME<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_NAME" title="Permalink to this definition">¶</a></dt>
<dd>Set Package control field (variable is automatically transformed to lower
case).
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li><a class="reference internal" href="../module/CPack.html#variable:CPACK_PACKAGE_NAME" title="CPACK_PACKAGE_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_NAME</code></a> for non-component based
installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_NAME" title="CPACK_DEBIAN_PACKAGE_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_NAME</code></a> suffixed with <code class="docutils literal notranslate">-&lt;COMPONENT&gt;</code>
for component-based installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.5: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_NAME</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-source">https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-source</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_FILE_NAME">
CPACK_DEBIAN_FILE_NAME<a class="headerlink" href="#variable:CPACK_DEBIAN_FILE_NAME" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_FILE_NAME">
CPACK_DEBIAN_&lt;COMPONENT&gt;_FILE_NAME<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_FILE_NAME" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.6.
</div>
Package file name.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">&lt;CPACK_PACKAGE_FILE_NAME&gt;[-&lt;component&gt;].deb</code>
</dd>
</dl>
This may be set to <code class="docutils literal notranslate">DEB-DEFAULT</code> to allow the CPack DEB generator to generate
package file name by itself in deb format:
<div class="highlight-none notranslate"><div class="highlight"><pre>&lt;PackageName&gt;_&lt;VersionNumber&gt;-&lt;DebianRevisionNumber&gt;_&lt;DebianArchitecture&gt;.deb
</pre></div>
</div>
Alternatively provided package file name must end
with either <code class="docutils literal notranslate">.deb</code> or <code class="docutils literal notranslate">.ipk</code> suffix.
<div class="versionadded">
New in version 3.10: <code class="docutils literal notranslate">.ipk</code> suffix used by OPKG packaging system.
</div>
<div class="admonition note">
Note
Preferred setting of this variable is <code class="docutils literal notranslate">DEB-DEFAULT</code> but for backward
compatibility with the CPack DEB generator in CMake prior to version 3.6 this
feature is disabled by default.
</div>
<div class="admonition note">
Note
By using non default filenames duplicate names may occur. Duplicate files
get overwritten and it is up to the packager to set the variables in a
manner that will prevent such errors.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_EPOCH">
CPACK_DEBIAN_PACKAGE_EPOCH<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_EPOCH" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.10.
</div>
The Debian package epoch
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">None
</dd>
</dl>
Optional number that should be incremented when changing versioning schemas
or fixing mistakes in the version numbers of older packages.
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_VERSION">
CPACK_DEBIAN_PACKAGE_VERSION<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_VERSION" title="Permalink to this definition">¶</a></dt>
<dd>The Debian package version
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><a class="reference internal" href="../module/CPack.html#variable:CPACK_PACKAGE_VERSION" title="CPACK_PACKAGE_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_VERSION</code></a>
</dd>
</dl>
This variable may contain only alphanumerics (A-Za-z0-9) and the characters
. + - ~ (full stop, plus, hyphen, tilde) and should start with a digit. If
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_RELEASE" title="CPACK_DEBIAN_PACKAGE_RELEASE"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_RELEASE</code></a> is not set then hyphens are not
allowed.
<div class="admonition note">
Note
For backward compatibility with CMake 3.9 and lower a failed test of this
variable's content is not a hard error when both
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_RELEASE" title="CPACK_DEBIAN_PACKAGE_RELEASE"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_RELEASE</code></a> and
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_EPOCH" title="CPACK_DEBIAN_PACKAGE_EPOCH"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_EPOCH</code></a> variables are not set. An author
warning is reported instead.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_RELEASE">
CPACK_DEBIAN_PACKAGE_RELEASE<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_RELEASE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.6.
</div>
The Debian package release - Debian revision number.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">None
</dd>
</dl>
This is the numbering of the DEB package itself, i.e. the version of the
packaging and not the version of the content (see
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_VERSION" title="CPACK_DEBIAN_PACKAGE_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_VERSION</code></a>). One may change the default value
if the previous packaging was buggy and/or you want to put here a fancy Linux
distro specific numbering.
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_ARCHITECTURE">
CPACK_DEBIAN_PACKAGE_ARCHITECTURE<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_ARCHITECTURE" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_ARCHITECTURE">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_ARCHITECTURE<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_ARCHITECTURE" title="Permalink to this definition">¶</a></dt>
<dd>The Debian package architecture
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">Output of <code class="docutils literal notranslate">dpkg --print-architecture</code> (or <code class="docutils literal notranslate">i386</code>
if <code class="docutils literal notranslate">dpkg</code> is not found)
</dd>
</dl>
<div class="versionadded">
New in version 3.6: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_ARCHITECTURE</code> variables.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_DEPENDS">
CPACK_DEBIAN_PACKAGE_DEPENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_DEPENDS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_DEPENDS" title="Permalink to this definition">¶</a></dt>
<dd>Sets the Debian dependencies of this package.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_DEPENDS" title="CPACK_DEBIAN_PACKAGE_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_DEPENDS</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.3: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS</code> variables.
</div>
<div class="admonition note">
Note
If <a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS" title="CPACK_DEBIAN_PACKAGE_SHLIBDEPS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_SHLIBDEPS</code></a> or
more specifically <a class="reference internal" href="#variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SHLIBDEPS" title="CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SHLIBDEPS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SHLIBDEPS</code></a>
is set for this component, the discovered dependencies will be appended
to <a class="reference internal" href="#variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS" title="CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS</code></a> instead of
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_DEPENDS" title="CPACK_DEBIAN_PACKAGE_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_DEPENDS</code></a>. If
<a class="reference internal" href="#variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS" title="CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_DEPENDS</code></a> is an empty string,
only the automatically discovered dependencies will be set for this
component.
</div>
Example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CPACK_DEBIAN_PACKAGE_DEPENDS &quot;libc6 (&gt;= 2.3.1-6), libc6 (&lt; 2.4)&quot;)
</pre></div>
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS">
CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_ENABLE_COMPONENT_DEPENDS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.6.
</div>
Sets inter-component dependencies if listed with
<a class="reference internal" href="../module/CPackComponent.html#variable:CPACK_COMPONENT_&lt;compName&gt;_DEPENDS" title="CPACK_COMPONENT_&lt;compName&gt;_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_COMPONENT_&lt;compName&gt;_DEPENDS</code></a> variables.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">None
</dd>
</dl>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_MAINTAINER">
CPACK_DEBIAN_PACKAGE_MAINTAINER<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_MAINTAINER" title="Permalink to this definition">¶</a></dt>
<dd>The Debian package maintainer
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_CONTACT</code>
</dd>
</dl>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_DESCRIPTION">
CPACK_DEBIAN_PACKAGE_DESCRIPTION<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_DESCRIPTION" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_DESCRIPTION">
CPACK_DEBIAN_&lt;COMPONENT&gt;_DESCRIPTION<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_DESCRIPTION" title="Permalink to this definition">¶</a></dt>
<dd>The Debian package description
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_DESCRIPTION" title="CPACK_DEBIAN_&lt;COMPONENT&gt;_DESCRIPTION"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_DESCRIPTION</code></a> (component
based installers only) if set, or <a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_DESCRIPTION" title="CPACK_DEBIAN_PACKAGE_DESCRIPTION"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_DESCRIPTION</code></a> if set, or</li>
<li><a class="reference internal" href="../module/CPackComponent.html#variable:CPACK_COMPONENT_&lt;compName&gt;_DESCRIPTION" title="CPACK_COMPONENT_&lt;compName&gt;_DESCRIPTION"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_COMPONENT_&lt;compName&gt;_DESCRIPTION</code></a> (component
based installers only) if set, or <a class="reference internal" href="../module/CPack.html#variable:CPACK_PACKAGE_DESCRIPTION" title="CPACK_PACKAGE_DESCRIPTION"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_DESCRIPTION</code></a> if set, or</li>
<li>content of the file specified in <a class="reference internal" href="../module/CPack.html#variable:CPACK_PACKAGE_DESCRIPTION_FILE" title="CPACK_PACKAGE_DESCRIPTION_FILE"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_DESCRIPTION_FILE</code></a> if set</li>
</ul>
</dd>
</dl>
If after that description is not set, <a class="reference internal" href="../module/CPack.html#variable:CPACK_PACKAGE_DESCRIPTION_SUMMARY" title="CPACK_PACKAGE_DESCRIPTION_SUMMARY"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_DESCRIPTION_SUMMARY</code></a> going to be
used if set. Otherwise, <a class="reference internal" href="../module/CPack.html#variable:CPACK_PACKAGE_DESCRIPTION_SUMMARY" title="CPACK_PACKAGE_DESCRIPTION_SUMMARY"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_DESCRIPTION_SUMMARY</code></a> will be added as the first
line of description as defined in <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-controlfields.html#description">Debian Policy Manual</a>.
<div class="versionadded">
New in version 3.3: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_COMPONENT_&lt;compName&gt;_DESCRIPTION</code> variables.
</div>
<div class="versionadded">
New in version 3.16: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_DESCRIPTION</code> variables.
</div>
<div class="versionadded">
New in version 3.16: The <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_PACKAGE_DESCRIPTION_FILE</code> variable.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_SECTION">
CPACK_DEBIAN_PACKAGE_SECTION<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_SECTION" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SECTION">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SECTION<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_SECTION" title="Permalink to this definition">¶</a></dt>
<dd>Set Section control field e.g. admin, devel, doc, ...
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">devel</code>
</dd>
</dl>
<div class="versionadded">
New in version 3.5: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SECTION</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections">https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_ARCHIVE_TYPE">
CPACK_DEBIAN_ARCHIVE_TYPE<a class="headerlink" href="#variable:CPACK_DEBIAN_ARCHIVE_TYPE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.7.
</div>
<div class="deprecated">
Deprecated since version 3.14.
</div>
The archive format used for creating the Debian package.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">gnutar</code>
</dd>
</dl>
Possible value is: <code class="docutils literal notranslate">gnutar</code>
<div class="admonition note">
Note
This variable previously defaulted to the <code class="docutils literal notranslate">paxr</code> value, but <code class="docutils literal notranslate">dpkg</code>
has never supported that tar format. For backwards compatibility the
<code class="docutils literal notranslate">paxr</code> value will be mapped to <code class="docutils literal notranslate">gnutar</code> and a deprecation message
will be emitted.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_COMPRESSION_TYPE">
CPACK_DEBIAN_COMPRESSION_TYPE<a class="headerlink" href="#variable:CPACK_DEBIAN_COMPRESSION_TYPE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
The compression used for creating the Debian package.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">gzip</code>
</dd>
</dl>
Possible values are:
<blockquote>
<div><dl>
<dt><code class="docutils literal notranslate">lzma</code></dt><dd>Lempel–Ziv–Markov chain algorithm
</dd>
<dt><code class="docutils literal notranslate">xz</code></dt><dd>XZ Utils compression
</dd>
<dt><code class="docutils literal notranslate">bzip2</code></dt><dd>bzip2 Burrows–Wheeler algorithm
</dd>
<dt><code class="docutils literal notranslate">gzip</code></dt><dd>GNU Gzip compression
</dd>
<dt><code class="docutils literal notranslate">zstd</code></dt><dd><div class="versionadded">
New in version 3.22.
</div>
Zstandard compression
</dd>
</dl>
</div></blockquote>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_PRIORITY">
CPACK_DEBIAN_PACKAGE_PRIORITY<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_PRIORITY" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PRIORITY">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PRIORITY<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_PRIORITY" title="Permalink to this definition">¶</a></dt>
<dd>Set Priority control field e.g. required, important, standard, optional,
extra
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">Yes
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">optional</code>
</dd>
</dl>
<div class="versionadded">
New in version 3.5: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PRIORITY</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities">https://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_HOMEPAGE">
CPACK_DEBIAN_PACKAGE_HOMEPAGE<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_HOMEPAGE" title="Permalink to this definition">¶</a></dt>
<dd>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.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><a class="reference internal" href="../variable/CMAKE_PROJECT_HOMEPAGE_URL.html#variable:CMAKE_PROJECT_HOMEPAGE_URL" title="CMAKE_PROJECT_HOMEPAGE_URL"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_PROJECT_HOMEPAGE_URL</code></a>
</dd>
</dl>
<div class="versionadded">
New in version 3.12: The <code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_PROJECT_HOMEPAGE_URL</code> variable.
</div>
<div class="admonition note">
Note
The content of this field is a simple URL without any surrounding
characters such as &lt;&gt;.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS">
CPACK_DEBIAN_PACKAGE_SHLIBDEPS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SHLIBDEPS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SHLIBDEPS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_SHLIBDEPS" title="Permalink to this definition">¶</a></dt>
<dd>May be set to ON in order to use <code class="docutils literal notranslate">dpkg-shlibdeps</code> to generate
better package dependency list.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS" title="CPACK_DEBIAN_PACKAGE_SHLIBDEPS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_SHLIBDEPS</code></a> if set or</li>
<li><code class="docutils literal notranslate">OFF</code></li>
</ul>
</dd>
</dl>
<div class="admonition note">
Note
You may need set <a class="reference internal" href="../variable/CMAKE_INSTALL_RPATH.html#variable:CMAKE_INSTALL_RPATH" title="CMAKE_INSTALL_RPATH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_INSTALL_RPATH</code></a> to an appropriate value
if you use this feature, because if you don't <code class="docutils literal notranslate">dpkg-shlibdeps</code>
may fail to find your own shared libs.
See <a class="reference external" href="https://gitlab.kitware.com/cmake/community/-/wikis/doc/cmake/RPATH-handling">https://gitlab.kitware.com/cmake/community/-/wikis/doc/cmake/RPATH-handling</a>
</div>
<div class="admonition note">
Note
You can also set <a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS" title="CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS</code></a>
to an appropriate value if you use this feature, in order to please
<code class="docutils literal notranslate">dpkg-shlibdeps</code>. However, you should only do this for private
shared libraries that could not get resolved otherwise.
</div>
<div class="versionadded">
New in version 3.3: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SHLIBDEPS</code> variables.
</div>
<div class="versionadded">
New in version 3.6: Correct handling of <code class="docutils literal notranslate">$ORIGIN</code> in <a class="reference internal" href="../variable/CMAKE_INSTALL_RPATH.html#variable:CMAKE_INSTALL_RPATH" title="CMAKE_INSTALL_RPATH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_INSTALL_RPATH</code></a>.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS">
CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_SHLIBDEPS_PRIVATE_DIRS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.20.
</div>
May be set to a list of directories that will be given to <code class="docutils literal notranslate">dpkg-shlibdeps</code>
via its <code class="docutils literal notranslate">-l</code> option. These will be searched by <code class="docutils literal notranslate">dpkg-shlibdeps</code> in order
to find private shared library dependencies.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">None
</dd>
</dl>
<div class="admonition note">
Note
You should prefer to set <a class="reference internal" href="../variable/CMAKE_INSTALL_RPATH.html#variable:CMAKE_INSTALL_RPATH" title="CMAKE_INSTALL_RPATH"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_INSTALL_RPATH</code></a> to an appropriate
value if you use <code class="docutils literal notranslate">dpkg-shlibdeps</code>. The current option is really only
needed for private shared library dependencies.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_DEBUG">
CPACK_DEBIAN_PACKAGE_DEBUG<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_DEBUG" title="Permalink to this definition">¶</a></dt>
<dd>May be set when invoking cpack in order to trace debug information
during the CPack DEB generator run.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">None
</dd>
</dl>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_PREDEPENDS">
CPACK_DEBIAN_PACKAGE_PREDEPENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_PREDEPENDS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PREDEPENDS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PREDEPENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_PREDEPENDS" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <cite>Pre-Depends</cite> field of the Debian package.
Like <a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_DEPENDS" title="CPACK_DEBIAN_PACKAGE_DEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">Depends</code></a>, except that it
also forces <code class="docutils literal notranslate">dpkg</code> to complete installation of the packages named
before even starting the installation of the package which declares the
pre-dependency.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_PREDEPENDS" title="CPACK_DEBIAN_PACKAGE_PREDEPENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_PREDEPENDS</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PREDEPENDS</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_ENHANCES">
CPACK_DEBIAN_PACKAGE_ENHANCES<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_ENHANCES" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_ENHANCES">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_ENHANCES<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_ENHANCES" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <code class="docutils literal notranslate">Enhances</code> field of the Debian package.
Similar to <a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_SUGGESTS" title="CPACK_DEBIAN_PACKAGE_SUGGESTS"><code class="xref cmake cmake-variable docutils literal notranslate">Suggests</code></a> but works
in the opposite direction: declares that a package can enhance the
functionality of another package.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_ENHANCES" title="CPACK_DEBIAN_PACKAGE_ENHANCES"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_ENHANCES</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_ENHANCES</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_BREAKS">
CPACK_DEBIAN_PACKAGE_BREAKS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_BREAKS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_BREAKS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_BREAKS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_BREAKS" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <code class="docutils literal notranslate">Breaks</code> field of the Debian package.
When a binary package (P) declares that it breaks other packages (B),
<code class="docutils literal notranslate">dpkg</code> will not allow the package (P) which declares <code class="docutils literal notranslate">Breaks</code> 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.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_BREAKS" title="CPACK_DEBIAN_PACKAGE_BREAKS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_BREAKS</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_BREAKS</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-breaks">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-breaks</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_CONFLICTS">
CPACK_DEBIAN_PACKAGE_CONFLICTS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_CONFLICTS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONFLICTS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONFLICTS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <cite>Conflicts</cite> field of the Debian package.
When one binary package declares a conflict with another using a <cite>Conflicts</cite>
field, <code class="docutils literal notranslate">dpkg</code> will not allow them to be unpacked on the system at
the same time.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_CONFLICTS" title="CPACK_DEBIAN_PACKAGE_CONFLICTS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_CONFLICTS</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONFLICTS</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-conflicts">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-conflicts</a>
<div class="admonition note">
Note
This is a stronger restriction than
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_BREAKS" title="CPACK_DEBIAN_PACKAGE_BREAKS"><code class="xref cmake cmake-variable docutils literal notranslate">Breaks</code></a>, which prevents the
broken package from being configured while the breaking package is in
the &quot;Unpacked&quot; state but allows both packages to be unpacked at the same
time.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_PROVIDES">
CPACK_DEBIAN_PACKAGE_PROVIDES<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_PROVIDES" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PROVIDES">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PROVIDES<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_PROVIDES" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <cite>Provides</cite> field of the Debian package.
A virtual package is one which appears in the <cite>Provides</cite> control field of
another package.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_PROVIDES" title="CPACK_DEBIAN_PACKAGE_PROVIDES"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_PROVIDES</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_PROVIDES</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-virtual">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-virtual</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_REPLACES">
CPACK_DEBIAN_PACKAGE_REPLACES<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_REPLACES" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_REPLACES">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_REPLACES<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <cite>Replaces</cite> 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.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_REPLACES" title="CPACK_DEBIAN_PACKAGE_REPLACES"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_REPLACES</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_REPLACES</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_RECOMMENDS">
CPACK_DEBIAN_PACKAGE_RECOMMENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_RECOMMENDS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_RECOMMENDS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_RECOMMENDS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <code class="docutils literal notranslate">Recommends</code> field of the Debian package.
Allows packages to declare a strong, but not absolute, dependency on other
packages.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_RECOMMENDS" title="CPACK_DEBIAN_PACKAGE_RECOMMENDS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_RECOMMENDS</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_RECOMMENDS</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_SUGGESTS">
CPACK_DEBIAN_PACKAGE_SUGGESTS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_SUGGESTS" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SUGGESTS">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SUGGESTS<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS" title="Permalink to this definition">¶</a></dt>
<dd>Sets the <cite>Suggests</cite> field of the Debian package.
Allows packages to declare a suggested package install grouping.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_SUGGESTS" title="CPACK_DEBIAN_PACKAGE_SUGGESTS"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_SUGGESTS</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SUGGESTS</code> variables.
</div>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps">https://www.debian.org/doc/debian-policy/ch-relationships.html#s-binarydeps</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS">
CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.6.
</div>
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">OFF</code>
</dd>
</dl>
Allows to generate shlibs control file automatically. Compatibility is defined by
<a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY" title="CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY</code></a> variable value.
<div class="admonition note">
Note
Libraries are only considered if they have both library name and version
set. This can be done by setting SOVERSION property with
<a class="reference internal" href="../command/set_target_properties.html#command:set_target_properties" title="set_target_properties"><code class="xref cmake cmake-command docutils literal notranslate">set_target_properties()</code></a> command.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY">
CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_GENERATE_SHLIBS_POLICY" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.6.
</div>
Compatibility policy for auto-generated shlibs control file.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">=</code>
</dd>
</dl>
Defines compatibility policy for auto-generated shlibs control file.
Possible values: <code class="docutils literal notranslate">=</code>, <code class="docutils literal notranslate">&gt;=</code>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-shlibdeps">https://www.debian.org/doc/debian-policy/ch-sharedlibs.html#s-sharedlibs-shlibdeps</a>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA">
CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONTROL_EXTRA">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONTROL_EXTRA<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONTROL_EXTRA" title="Permalink to this definition">¶</a></dt>
<dd>This variable allow advanced user to add custom script to the
control.tar.gz.
Typical usage is for conffiles, postinst, postrm, prerm.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even">None
</dd>
</dl>
Usage:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CPACK_DEBIAN_PACKAGE_CONTROL_EXTRA
 &quot;${CMAKE_CURRENT_SOURCE_DIR}/prerm;${CMAKE_CURRENT_SOURCE_DIR}/postrm&quot;)
</pre></div>
</div>
<div class="versionadded">
New in version 3.4: Per-component <code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONTROL_EXTRA</code> variables.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION">
CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONTROL_STRICT_PERMISSION">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_CONTROL_STRICT_PERMISSION<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONTROL_STRICT_PERMISSION" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.4.
</div>
This variable indicates if the Debian policy on control files should be
strictly followed.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">FALSE</code>
</dd>
</dl>
Usage:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(CPACK_DEBIAN_PACKAGE_CONTROL_STRICT_PERMISSION TRUE)
</pre></div>
</div>
This overrides the permissions on the original files, following the rules
set by Debian policy
<a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-files.html#s-permissions-owners">https://www.debian.org/doc/debian-policy/ch-files.html#s-permissions-owners</a>
<div class="admonition note">
Note
The original permissions of the files will be used in the final
package unless this variable is set to <code class="docutils literal notranslate">TRUE</code>.
In particular, the scripts should have the proper executable
flag prior to the generation of the package.
</div>
</dd></dl>

<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_PACKAGE_SOURCE">
CPACK_DEBIAN_PACKAGE_SOURCE<a class="headerlink" href="#variable:CPACK_DEBIAN_PACKAGE_SOURCE" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SOURCE">
CPACK_DEBIAN_&lt;COMPONENT&gt;_PACKAGE_SOURCE<a class="headerlink" href="#variable:CPACK_DEBIAN_<COMPONENT>_PACKAGE_SOURCE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.5.
</div>
Sets the <code class="docutils literal notranslate">Source</code> 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 <code class="docutils literal notranslate">Source</code>.
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><ul class="simple">
<li>An empty string for non-component based installations</li>
<li><a class="reference internal" href="#variable:CPACK_DEBIAN_PACKAGE_SOURCE" title="CPACK_DEBIAN_PACKAGE_SOURCE"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_DEBIAN_PACKAGE_SOURCE</code></a> for component-based
installations.</li>
</ul>
</dd>
</dl>
See <a class="reference external" href="https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-source">https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-source</a>
<div class="admonition note">
Note
This value is not interpreted. It is possible to pass an optional
revision number of the referenced source package as well.
</div>
</dd></dl>

</section>
<section id="packaging-of-debug-information">
<h2>Packaging of debug information<a class="headerlink" href="#packaging-of-debug-information" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.13.
</div>
Dbgsym packages contain debug symbols for debugging packaged binaries.
Dbgsym packaging has its own set of variables:
<dl class="cmake variable">
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_DEBUGINFO_PACKAGE">
CPACK_DEBIAN_DEBUGINFO_PACKAGE<a class="headerlink" href="#variable:CPACK_DEBIAN_DEBUGINFO_PACKAGE" title="Permalink to this definition">¶</a></dt>
<dt class="sig sig-object cmake" id="variable:CPACK_DEBIAN_&lt;component&gt;_DEBUGINFO_PACKAGE">
CPACK_DEBIAN_&lt;component&gt;_DEBUGINFO_PACKAGE<a class="headerlink" href="#variable:CPACK_DEBIAN_<component>_DEBUGINFO_PACKAGE" title="Permalink to this definition">¶</a></dt>
<dd>Enable generation of dbgsym .ddeb package(s).
<dl class="field-list simple">
<dt class="field-odd">Mandatory:</dt>
<dd class="field-odd">No
</dd>
<dt class="field-even">Default:</dt>
<dd class="field-even"><code class="docutils literal notranslate">OFF</code>
</dd>
</dl>
</dd></dl>

<div class="admonition note">
Note
Setting this also strips the ELF files in the generated non-dbgsym package,
which results in debuginfo only being available in the dbgsym package.
</div>
<div class="admonition note">
Note
Binaries must contain debug symbols before packaging so use either <code class="docutils literal notranslate">Debug</code>
or <code class="docutils literal notranslate">RelWithDebInfo</code> for <a class="reference internal" href="../variable/CMAKE_BUILD_TYPE.html#variable:CMAKE_BUILD_TYPE" title="CMAKE_BUILD_TYPE"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_BUILD_TYPE</code></a> variable value.
Additionally, if <a class="reference internal" href="../module/CPack.html#variable:CPACK_STRIP_FILES" title="CPACK_STRIP_FILES"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_STRIP_FILES</code></a> is set, the files will be stripped before
they get to the DEB generator, so will not contain debug symbols and
a dbgsym package will not get built. Do not use with <a class="reference internal" href="../module/CPack.html#variable:CPACK_STRIP_FILES" title="CPACK_STRIP_FILES"><code class="xref cmake cmake-variable docutils literal notranslate">CPACK_STRIP_FILES</code></a>.
</div>
</section>
<section id="building-debian-packages-on-windows">
<h2>Building Debian packages on Windows<a class="headerlink" href="#building-debian-packages-on-windows" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.10.
</div>
To communicate UNIX file permissions from the install stage
to the CPack DEB generator the <code class="docutils literal notranslate">cmake_mode_t</code> NTFS
alternate data stream (ADT) is used.
When a filesystem without ADT support is used only owner read/write
permissions can be preserved.
</section>
<section id="reproducible-packages">
<h2>Reproducible packages<a class="headerlink" href="#reproducible-packages" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.13.
</div>
The environment variable <code class="xref cmake cmake-envvar docutils literal notranslate">SOURCE_DATE_EPOCH</code> 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
use its value for timestamps in the package.
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">CPack DEB Generator</a><ul>
<li><a class="reference internal" href="#variables-specific-to-cpack-debian-deb-generator">Variables specific to CPack Debian (DEB) generator</a></li>
<li><a class="reference internal" href="#packaging-of-debug-information">Packaging of debug information</a></li>
<li><a class="reference internal" href="#building-debian-packages-on-windows">Building Debian packages on Windows</a></li>
<li><a class="reference internal" href="#reproducible-packages">Reproducible packages</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="cygwin.html"
 title="previous chapter">CPack Cygwin Generator</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="dmg.html"
 title="next chapter">CPack DragNDrop Generator</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/cpack_gen/deb.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="../search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="dmg.html" title="CPack DragNDrop Generator"
 >next</a> |</li>
 <li class="right" >
 <a href="cygwin.html" title="CPack Cygwin Generator"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cpack-generators.7.html" >cpack-generators(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">CPack DEB Generator</a></li> 
 </ul>
 </div>

<div class="footer" role="contentinfo">
 &#169; Copyright 2000-2023 Kitware, Inc. and Contributors.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 5.0.2.
 </div>
 </body>
</html>