/ usr / share / cmake-3.22 / Help / cpack_gen / [ HOME SHELL ]

Name	Size	Permission	Action
archive.rst	2.9 KB	-rw-r--r--
bundle.rst	2.47 KB	-rw-r--r--
cygwin.rst	735 B	-rw-r--r--
deb.rst	21.21 KB	-rw-r--r--
dmg.rst	4.76 KB	-rw-r--r--
external.rst	11.58 KB	-rw-r--r--
freebsd.rst	5.13 KB	-rw-r--r--
ifw.rst	10.63 KB	-rw-r--r--
nsis.rst	5.92 KB	-rw-r--r--
nuget.rst	7.74 KB	-rw-r--r--
packagemaker.rst	2.92 KB	-rw-r--r--
productbuild.rst	4.14 KB	-rw-r--r--
rpm.rst	32.66 KB	-rw-r--r--
wix.rst	9.76 KB	-rw-r--r--

Code Editor : archive.rst

CPack Archive Generator
-----------------------

CPack generator for packaging files into an archive, which can have
any of the following formats:

- 7Z - 7zip - (.7z)
  - TBZ2 (.tar.bz2)
  - TGZ (.tar.gz)
  - TXZ (.tar.xz)
  - TZ (.tar.Z)
  - TZST (.tar.zst)
  - ZIP (.zip)

.. versionadded:: 3.1
  ``7Z`` and ``TXZ`` formats support.

.. versionadded:: 3.16
  ``TZST`` format support.

When this generator is called from ``CPackSourceConfig.cmake`` (or through
the ``package_source`` target), then the generated archive will contain all
files in the project directory, except those specified in
:variable:`CPACK_SOURCE_IGNORE_FILES`.  The following is one example of
packaging all source files of a project:

.. code-block:: cmake

set(CPACK_SOURCE_GENERATOR "TGZ")
  set(CPACK_SOURCE_IGNORE_FILES
    \\.git/
    build/
    ".*~$"
  )
  set(CPACK_VERBATIM_VARIABLES YES)
  include(CPack)

When this generator is called from ``CPackConfig.cmake`` (or through the
``package`` target), then the generated archive will contain all files
that have been installed via CMake's :command:`install` command (and the
deprecated commands :command:`install_files`, :command:`install_programs`,
and :command:`install_targets`).

Variables specific to CPack Archive generator
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. variable:: CPACK_ARCHIVE_FILE_NAME
              CPACK_ARCHIVE_<component>_FILE_NAME

Package file name without extension. The extension is determined from the
  archive format (see list above) and automatically appended to the file name.
  The default is ``<CPACK_PACKAGE_FILE_NAME>[-<component>]``, with spaces
  replaced by '-'.

.. versionadded:: 3.9
    Per-component ``CPACK_ARCHIVE_<component>_FILE_NAME`` variables.

.. variable:: CPACK_ARCHIVE_COMPONENT_INSTALL

Enable component packaging. If enabled (ON), then the archive generator
  creates  multiple packages. The default is OFF, which means that a single
  package containing files of all components is generated.

Variables used by CPack Archive generator
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

These variables are used by the Archive generator, but are also available to
CPack generators which are essentially archives at their core. These include:

- :cpack_gen:`CPack Cygwin Generator`
  - :cpack_gen:`CPack FreeBSD Generator`

.. variable:: CPACK_ARCHIVE_THREADS

.. versionadded:: 3.18

The number of threads to use when performing the compression. If set to
  ``0``, the number of available cores on the machine will be used instead.
  The default is ``1`` which limits compression to a single thread. Note that
  not all compression modes support threading in all environments. Currently,
  only the XZ compression may support it.

See also the :variable:`CPACK_THREADS` variable.

.. versionadded:: 3.21

Official CMake binaries available on ``cmake.org`` now ship
    with a ``liblzma`` that supports parallel compression.
    Older versions did not.

Urban Research Lab

Urban Research Lab

The Urban Research Lab (URL) at IIIT-Delhi was established in 2020, during a time when the pandemic brought the complexities of urban life more visible than ever. What started as an initiative by faculty and students has grown into a collaborative space for critically exploring and reimagining the urban questions through research, dialogue, and interdisciplinary engagement.