cpack1

<generators> is a semicolon-separated list <#cmake-language-lists> of generator names. cpack will iterate through this list and produce package(s) in that generator's format according to the details provided in the CPackConfig.cmake configuration file. If this option is not given, the CPACK_GENERATOR <#variable:CPACK_GENERATOR> variable determines the default set of generators that will be used.

Specify the project configuration(s) to be packaged (e.g. Debug, Release, etc.), where <configurations> is a semicolon-separated list <#cmake-language-lists>. When the CMake project uses a multi-configuration generator such as Xcode <#generator:Xcode> or Visual Studio <#visual-studio-generators>, this option is needed to tell cpack which built executables to include in the package. The user is responsible for ensuring that the configuration(s) listed have already been built before invoking cpack.

Set a CPack variable. This will override any value set for <var> in the input file read by cpack.

Added in version 4.0: The single-argument form -D<var>=<value> is now supported.

Specify the configuration file read by cpack to provide the packaging details. By default, CPackConfig.cmake in the current directory will be used.

Run cpack with verbose output. This can be used to show more details from the package generation tools and is suitable for project developers.

Run cpack with debug output. This option is intended mainly for the developers of cpack itself and is not normally needed by project developers.

Put the underlying cmake scripts in trace mode.

Put the underlying cmake scripts in expanded trace mode.

Override/define the value of the CPACK_PACKAGE_NAME <#variable:CPACK_PACKAGE_NAME> variable used for packaging. Any value set for this variable in the CPackConfig.cmake file will then be ignored.

Override/define the value of the CPACK_PACKAGE_VERSION <#variable:CPACK_PACKAGE_VERSION> variable used for packaging. It will override a value set in the CPackConfig.cmake file or one automatically computed from CPACK_PACKAGE_VERSION_MAJOR <#variable:CPACK_PACKAGE_VERSION_MAJOR>, CPACK_PACKAGE_VERSION_MINOR <#variable:CPACK_PACKAGE_VERSION_MINOR> and CPACK_PACKAGE_VERSION_PATCH <#variable:CPACK_PACKAGE_VERSION_PATCH>.

Override/define CPACK_PACKAGE_DIRECTORY <#variable: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_Packages subdirectory will also be created below this directory to use as a working area during package creation.

Override/define CPACK_PACKAGE_VENDOR <#variable:CPACK_PACKAGE_VENDOR>.

Use a package preset <#manual:cmake-presets(7)> to specify package options. The project binary directory is inferred from the configurePreset <#cmakepresets-packagepresets-configurepreset> key.

Changed in version 4.4: If --presets-file is specified, neither of CMakePresets.json nor CMakeUserPresets.json are required to be present. Otherwise, they are required to be present in the top level source directory. In prior versions, this was strictly required.

Added in version 4.4.

Reads presets <#manual:cmake-presets(7)> from the given <file>. The specified path may be absolute or relative to the current working directory. If --presets-file is given, presets defined in CMakePresets.json and CMakeUserPresets.json will be ignored.

Lists the available package presets.

Changed in version 4.4: If --presets-file is specified, neither of CMakePresets.json nor CMakeUserPresets.json are required to be present, and only presets defined in the given <file> will be listed. Otherwise, they are required to be present in the top level source directory. In prior versions, this was strictly required.

Print all help manuals and exit.

All manuals are printed in a human-readable text format. The output is printed to a named <file> if given.

List help manuals available and exit.

The list contains all manuals for which help may be obtained by using the --help-manual option followed by a manual name. The output is printed to a named <file> if given.

List commands with help available and exit.

The list contains all commands for which help may be obtained by using the --help-command option followed by a command name. The output is printed to a named <file> if given.

Print cmake-commands manual and exit.

The cmake-commands(7) <#manual:cmake-commands(7)> manual is printed in a human-readable text format. The output is printed to a named <file> if given.

List modules with help available and exit.

The list contains all modules for which help may be obtained by using the --help-module option followed by a module name. The output is printed to a named <file> if given.

Print cmake-modules manual and exit.

The cmake-modules(7) <#manual:cmake-modules(7)> manual is printed in a human-readable text format. The output is printed to a named <file> if given.

List policies with help available and exit.

The list contains all policies for which help may be obtained by using the --help-policy option followed by a policy name. The output is printed to a named <file> if given.

Print cmake-policies manual and exit.

The cmake-policies(7) <#manual:cmake-policies(7)> manual is printed in a human-readable text format. The output is printed to a named <file> if given.

List properties with help available and exit.

The list contains all properties for which help may be obtained by using the --help-property option followed by a property name. The output is printed to a named <file> if given.

Print cmake-properties manual and exit.

The cmake-properties(7) <#manual:cmake-properties(7)> manual is printed in a human-readable text format. The output is printed to a named <file> if given.

List variables with help available and exit.

The list contains all variables for which help may be obtained by using the --help-variable option followed by a variable name. The output is printed to a named <file> if given.

Print cmake-variables manual and exit.

The cmake-variables(7) <#manual:cmake-variables(7)> manual is printed in a human-readable text format. The output is printed to a named <file> if given.