cpack(1)
NAME
cpack – CPack Command-Line Reference
SYNOPSIS
cpack [<options>]
DESCRIPTION
The cpack executable is the CMake packaging program. It generates installers and source packages in a variety of formats.
For each installer or package format, cpack has a specific backend, called "generator". A generator is responsible for generating the required inputs and invoking the specific package creation tools. These installer or package generators are not to be confused with the makefile generators of the cmake command.
All supported generators are specified in the cpack-generators manual. The command cpack –help prints a list of generators supported for the target platform. Which of them are to be used can be selected through the CPACK_GENERATOR variable or through the command-line option -G.
The cpack program is steered by a configuration file written in the CMake language. Unless chosen differently through the command-line option –config, the file CPackConfig.cmake in the current directory is used.
In the standard CMake workflow, the file CPackConfig.cmake is generated by the cmake executable, provided the CPack module is included by the project’s CMakeLists.txt file.
OPTIONS
-G <generators><generators>is a semicolon-separated list of generator names.cpackwill iterate through this list and produce package(s) in that generator’s format according to the details provided in theCPackConfig.cmakeconfiguration file. If this option is not given, theCPACK_GENERATORvariable determines the default set of generators that will be used.-C <configs>- Specify the project configuration(s) to be packaged (e.g.
Debug,Release, etc.), where<configs>is a semicolon-separated list. When the CMake project uses a multi-configuration generator such as Xcode or Visual Studio, this option is needed to tellcpackwhich built executables to include in the package. The user is responsible for ensuring that the configuration(s) listed have already been built before invokingcpack. -D <var>=<value>- Set a CPack variable. This will override any value set for
<var>in the input file read bycpack. –config <configFile>- Specify the configuration file read by
cpackto provide the packaging details. By default,CPackConfig.cmakein the current directory will be used. –verbose, -V- Run
cpackwith verbose output. This can be used to show more details from the package generation tools and is suitable for project developers. –debug- Run
cpackwith debug output. This option is intended mainly for the developers ofcpackitself and is not normally needed by project developers. –trace- Put the underlying cmake scripts in trace mode.
–trace-expand- Put the underlying cmake scripts in expanded trace mode.
-P <packageName>- Override/define the value of the
CPACK_PACKAGE_NAMEvariable used for packaging. Any value set for this variable in theCPackConfig.cmakefile will then be ignored. -R <packageVersion>- Override/define the value of the
CPACK_PACKAGE_VERSIONvariable used for packaging. It will override a value set in theCPackConfig.cmakefile or one automatically computed fromCPACK_PACKAGE_VERSION_MAJOR,CPACK_PACKAGE_VERSION_MINORandCPACK_PACKAGE_VERSION_PATCH. -B <packageDirectory>- Override/define
CPACK_PACKAGE_DIRECTORY, which controls the directory where CPack will perform its packaging work. The resultant package(s) will be created at this location by default and a_CPack_Packagessubdirectory will also be created below this directory to use as a working area during package creation. –vendor <vendorName>- Override/define
CPACK_PACKAGE_VENDOR. –help,-help,-usage,-h,-H,/?- Print usage information and exit.
–version,-version,/V [<f>]- Show program name/version banner and exit.
–help-full [<f>]- Print all help manuals and exit.
–help-manual <man> [<f>]- Print one help manual and exit.
–help-manual-list [<f>]- List help manuals available and exit.
–help-command <cmd> [<f>]- Print help for one command and exit.
–help-command-list [<f>]- List commands with help available and exit.
–help-commands [<f>]- Print cmake-commands manual and exit.
–help-module <mod> [<f>]- Print help for one module and exit.
–help-module-list [<f>]- List modules with help available and exit.
–help-modules [<f>]- Print cmake-modules manual and exit.
–help-policy <cmp> [<f>]- Print help for one policy and exit.
–help-policy-list [<f>]- List policies with help available and exit.
–help-policies [<f>]- Print cmake-policies manual and exit.
–help-property <prop> [<f>]- Print help for one property and exit.
–help-property-list [<f>]- List properties with help available and exit.
–help-properties [<f>]- Print cmake-properties manual and exit.
–help-variable <var> [<f>]- Print help for one variable and exit.
–help-variable-list [<f>]- List variables with help available and exit.
–help-variables [<f>]- Print cmake-variables manual and exit.
Usage describes the basic command line interface and its options.
If a file is specified, the version is written into it. The help is printed to a named <f>ile if given.
All manuals are printed in a human-readable text format. The help is printed to a named <f>ile if given.
The specified manual is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The list contains all manuals for which help may be obtained by using the –help-manual option followed by a manual name. The help is printed to a named <f>ile if given.
The cmake-commands(7) manual entry for <cmd> is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The list contains all commands for which help may be obtained by using the –help-command option followed by a command name. The help is printed to a named <f>ile if given.
The cmake-commands(7) manual is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The cmake-modules(7) manual entry for <mod> is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The list contains all modules for which help may be obtained by using the –help-module option followed by a module name. The help is printed to a named <f>ile if given.
The cmake-modules(7) manual is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The cmake-policies(7) manual entry for <cmp> is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The list contains all policies for which help may be obtained by using the –help-policy option followed by a policy name. The help is printed to a named <f>ile if given.
The cmake-policies(7) manual is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The cmake-properties(7) manual entries for <prop> are printed in a human-readable text format. The help is printed to a named <f>ile if given.
The list contains all properties for which help may be obtained by using the –help-property option followed by a property name. The help is printed to a named <f>ile if given.
The cmake-properties(7) manual is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The cmake-variables(7) manual entry for <var> is printed in a human-readable text format. The help is printed to a named <f>ile if given.
The list contains all variables for which help may be obtained by using the –help-variable option followed by a variable name. The help is printed to a named <f>ile if given.
The cmake-variables(7) manual is printed in a human-readable text format. The help is printed to a named <f>ile if given.
SEE ALSO
The following resources are available to get help using CMake:
Home Page- https://cmake.org
Online Documentation and Community Resources- https://cmake.org/documentation
Discourse Forum- https://discourse.cmake.org
The primary starting point for learning about CMake.
Links to available documentation and community resources may be found on this web page.
The Discourse Forum hosts discussion and questions about CMake.
COPYRIGHT
2000-2022 Kitware, Inc. and Contributors