Textmate Rpm Spec File

The built in (binary) CPack RPM generator (Unix only)

They are processed identically to the string type (6). In file format 3, as documented in Maximum RPM, the string type could only have a count of 1. There was a String Array type, assigned the value of 8, which was used for entries with multiple strings. There was also an internationalized string type.

Variables specific to CPack RPM generator¶

CPackRPM may be used to create RPM packages using CPack.CPackRPM is a CPack generator thus it uses the CPACK_XXXvariables used by CPack.

CPackRPM has specific features which are controlled by the specificsCPACK_RPM_XXX variables.

CPACK_RPM_<COMPONENT>_XXXX variables may be used in order to havecomponent specific values. Note however that <COMPONENT> refers to thegrouping name written in upper case. It may be either a component name ora component GROUP name. Usually those variables correspond to RPM spec fileentities. One may find information about spec files herehttp://www.rpm.org/wiki/Docs

Note

<COMPONENT> part of variables is preferred to be in upper case (for e.g. ifcomponent is named foo then use CPACK_RPM_FOO_XXXX variable name format)as is with other CPACK_<COMPONENT>_XXXX variables.For the purposes of back compatibility (CMake/CPack version 3.5 and lower)support for same cased component (e.g. fOo would be used asCPACK_RPM_fOo_XXXX) is still supported for variables defined in olderversions of CMake/CPack but is not guaranteed for variables thatwill be added in the future. For the sake of back compatibility same casedcomponent variables also override upper cased versions where both arepresent.

Here are some CPackRPM wiki resources that are here for historic reasons andare no longer maintained but may still prove useful:

List of CPackRPM specific variables:

CPACK_RPM_COMPONENT_INSTALL

Enable component packaging for CPackRPM

  • Mandatory : NO
  • Default : OFF

If enabled (ON) multiple packages are generated. By default a single packagecontaining files of all components is generated.

CPACK_RPM_PACKAGE_SUMMARY
CPACK_RPM_<component>_PACKAGE_SUMMARY_PACKAGE_SUMMARY'>¶

The RPM package summary.

  • Mandatory : YES
  • Default : CPACK_PACKAGE_DESCRIPTION_SUMMARY
CPACK_RPM_PACKAGE_NAME
CPACK_RPM_<component>_PACKAGE_NAME_PACKAGE_NAME'>¶

The RPM package name.

  • Mandatory : YES
  • Default : CPACK_PACKAGE_NAME
CPACK_RPM_FILE_NAME
CPACK_RPM_<component>_FILE_NAME_FILE_NAME'>¶

Package file name.

  • Mandatory : YES

  • Default :<CPACK_PACKAGE_FILE_NAME>[-<component>].rpm with spaces

    replaced by ‘-‘

This may be set to RPM-DEFAULT to allow rpmbuild tool to generate packagefile name by itself.Alternatively provided package file name must end with .rpm suffix.

Note

By using user provided spec file, rpm macro extensions such as forgenerating debuginfo packages or by simply using multiple components morethan one rpm file may be generated, either from a single spec file or frommultiple spec files (each component execution produces it’s own spec file).In such cases duplicate file names may occur as a result of this variablesetting or spec file content structure. Duplicate files get overwrittenand it is up to the packager to set the variables in a manner that willprevent such errors.

CPACK_RPM_PACKAGE_VERSION

The RPM package version.

  • Mandatory : YES
  • Default : CPACK_PACKAGE_VERSION
CPACK_RPM_PACKAGE_ARCHITECTURE
CPACK_RPM_<component>_PACKAGE_ARCHITECTURE_PACKAGE_ARCHITECTURE'>¶

The RPM package architecture.

  • Mandatory : YES
  • Default : Native architecture output by uname-m

This may be set to noarch if you know you are building a noarch package.

CPACK_RPM_PACKAGE_RELEASE

The RPM package release.

  • Mandatory : YES
  • Default : 1

This is the numbering of the RPM package itself, i.e. the version of thepackaging and not the version of the content (seeCPACK_RPM_PACKAGE_VERSION). One may change the default value ifthe previous packaging was buggy and/or you want to put here a fancy Linuxdistro specific numbering.

Note

This is the string that goes into the RPM Release: field. Some distros(e.g. Fedora, CentOS) require 1%{?dist} format and not just a number.%{?dist} part can be added by setting CPACK_RPM_PACKAGE_RELEASE_DIST.

CPACK_RPM_PACKAGE_RELEASE_DIST

The dist tag that is added RPM Release: field.

  • Mandatory : NO
  • Default : OFF

This is the reported %{dist} tag from the current distribution or empty%{dist} if RPM macro is not set. If this variable is set then RPMRelease: field value is set to ${CPACK_RPM_PACKAGE_RELEASE}%{?dist}.

CPACK_RPM_PACKAGE_LICENSE

The RPM package license policy.

  • Mandatory : YES
  • Default : “unknown”
CPACK_RPM_PACKAGE_GROUP
CPACK_RPM_<component>_PACKAGE_GROUP_PACKAGE_GROUP'>¶

The RPM package group.

  • Mandatory : YES
  • Default : “unknown”
CPACK_RPM_PACKAGE_VENDOR

The RPM package vendor.

  • Mandatory : YES
  • Default : CPACK_PACKAGE_VENDOR if set or “unknown”
CPACK_RPM_PACKAGE_URL
CPACK_RPM_<component>_PACKAGE_URL_PACKAGE_URL'>¶

The projects URL.

  • Mandatory : NO
  • Default : -
CPACK_RPM_PACKAGE_DESCRIPTION
CPACK_RPM_<component>_PACKAGE_DESCRIPTION_PACKAGE_DESCRIPTION'>¶

RPM package description.

  • Mandatory : YES
  • Default : _DESCRIPTION'>CPACK_COMPONENT_<compName>_DESCRIPTION (componentbased installers only) if set, CPACK_PACKAGE_DESCRIPTION_FILEif set or “no package description available”
CPACK_RPM_COMPRESSION_TYPE

RPM compression type.

  • Mandatory : NO
  • Default : -

May be used to override RPM compression type to be used to build theRPM. For example some Linux distribution now default to lzma or xzcompression whereas older cannot use such RPM. Using this one can enforcecompression type to be used.

Possible values are:

  • lzma
  • xz
  • bzip2
  • gzip
CPACK_RPM_PACKAGE_AUTOREQ
CPACK_RPM_<component>_PACKAGE_AUTOREQ_PACKAGE_AUTOREQ'>¶

RPM spec autoreq field.

  • Mandatory : NO
  • Default : -

May be used to enable (1, yes) or disable (0, no) automatic shared librariesdependency detection. Dependencies are added to requires list.

Note

By default automatic dependency detection is enabled by rpm generator.

CPACK_RPM_PACKAGE_AUTOPROV
CPACK_RPM_<component>_PACKAGE_AUTOPROV_PACKAGE_AUTOPROV'>¶

RPM spec autoprov field.

  • Mandatory : NO
  • Default : -

May be used to enable (1, yes) or disable (0, no) automatic listing of sharedlibraries that are provided by the package. Shared libraries are added toprovides list.

Note

By default automatic provides detection is enabled by rpm generator.

CPACK_RPM_PACKAGE_AUTOREQPROV
CPACK_RPM_<component>_PACKAGE_AUTOREQPROV_PACKAGE_AUTOREQPROV'>¶

RPM spec autoreqprov field.

  • Mandatory : NO
  • Default : -

Variable enables/disables autoreq and autoprov at the same time.See CPACK_RPM_PACKAGE_AUTOREQ and CPACK_RPM_PACKAGE_AUTOPROVfor more details.

Note

By default automatic detection feature is enabled by rpm.

CPACK_RPM_PACKAGE_REQUIRES
CPACK_RPM_<component>_PACKAGE_REQUIRES_PACKAGE_REQUIRES'>¶

RPM spec requires field.

  • Mandatory : NO
  • Default : -

May be used to set RPM dependencies (requires). Note that you must enclosethe complete requires string between quotes, for example:

The required package list of an RPM file could be printed with:

CPACK_RPM_PACKAGE_CONFLICTS
CPACK_RPM_<component>_PACKAGE_CONFLICTS_PACKAGE_CONFLICTS'>¶

RPM spec conflicts field.

  • Mandatory : NO
  • Default : -

May be used to set negative RPM dependencies (conflicts). Note that you mustenclose the complete requires string between quotes, for example:

The conflicting package list of an RPM file could be printed with:

CPACK_RPM_PACKAGE_REQUIRES_PRE
CPACK_RPM_<component>_PACKAGE_REQUIRES_PRE_PACKAGE_REQUIRES_PRE'>¶

RPM spec requires(pre) field.

  • Mandatory : NO
  • Default : -

May be used to set RPM preinstall dependencies (requires(pre)). Note thatyou must enclose the complete requires string between quotes, for example:

CPACK_RPM_PACKAGE_REQUIRES_POST
CPACK_RPM_<component>_PACKAGE_REQUIRES_POST_PACKAGE_REQUIRES_POST'>¶

RPM spec requires(post) field.

  • Mandatory : NO
  • Default : -

May be used to set RPM postinstall dependencies (requires(post)). Note thatyou must enclose the complete requires string between quotes, for example:

CPACK_RPM_PACKAGE_REQUIRES_POSTUN
CPACK_RPM_<component>_PACKAGE_REQUIRES_POSTUN_PACKAGE_REQUIRES_POSTUN'>¶

RPM spec requires(postun) field.

  • Mandatory : NO
  • Default : -

May be used to set RPM postuninstall dependencies (requires(postun)). Notethat you must enclose the complete requires string between quotes, forexample:

CPACK_RPM_PACKAGE_REQUIRES_PREUN
CPACK_RPM_<component>_PACKAGE_REQUIRES_PREUN_PACKAGE_REQUIRES_PREUN'>¶

RPM spec requires(preun) field.

  • Mandatory : NO
  • Default : -

May be used to set RPM preuninstall dependencies (requires(preun)). Note thatyou must enclose the complete requires string between quotes, for example:

CPACK_RPM_PACKAGE_SUGGESTS
CPACK_RPM_<component>_PACKAGE_SUGGESTS_PACKAGE_SUGGESTS'>¶

RPM spec suggest field.

  • Mandatory : NO
  • Default : -

May be used to set weak RPM dependencies (suggests). Note that you mustenclose the complete requires string between quotes.

CPACK_RPM_PACKAGE_PROVIDES
CPACK_RPM_<component>_PACKAGE_PROVIDES_PACKAGE_PROVIDES'>¶

RPM spec provides field.

  • Mandatory : NO
  • Default : -

May be used to set RPM dependencies (provides). The provided package listof an RPM file could be printed with:

CPACK_RPM_PACKAGE_OBSOLETES
CPACK_RPM_<component>_PACKAGE_OBSOLETES_PACKAGE_OBSOLETES'>¶

RPM spec obsoletes field.

  • Mandatory : NO
  • Default : -

May be used to set RPM packages that are obsoleted by this one.

CPACK_RPM_PACKAGE_RELOCATABLE

build a relocatable RPM.

  • Mandatory : NO
  • Default : CPACK_PACKAGE_RELOCATABLE

If this variable is set to TRUE or ON CPackRPM will tryto build a relocatable RPM package. A relocatable RPM maybe installed using:

in order to install it at an alternate place see rpm(8). Note thatcurrently this may fail if CPACK_SET_DESTDIR is set to ON. IfCPACK_SET_DESTDIR is set then you will get a warning message butif there is file installed with absolute path you’ll get unexpected behavior.

CPACK_RPM_SPEC_INSTALL_POST

Deprecated - use CPACK_RPM_POST_INSTALL_SCRIPT_FILE instead.

  • Mandatory : NO
  • Default : -
  • Deprecated: YES

This way of specifying post-install script is deprecated, useCPACK_RPM_POST_INSTALL_SCRIPT_FILE.May be used to set an RPM post-install command inside the spec file.For example setting it to /bin/true may be used to preventrpmbuild to strip binaries.

CPACK_RPM_SPEC_MORE_DEFINE

RPM extended spec definitions lines.

  • Mandatory : NO
  • Default : -

May be used to add any %define lines to the generated spec file.

CPACK_RPM_PACKAGE_DEBUG

Toggle CPackRPM debug output.

  • Mandatory : NO
  • Default : -

May be set when invoking cpack in order to trace debug informationduring CPack RPM run. For example you may launch CPack like this:

CPACK_RPM_USER_BINARY_SPECFILE
CPACK_RPM_<componentName>_USER_BINARY_SPECFILE_USER_BINARY_SPECFILE'>¶

A user provided spec file.

  • Mandatory : NO
  • Default : -

May be set by the user in order to specify a USER binary spec fileto be used by CPackRPM instead of generating the file.The specified file will be processed by configure_file( @ONLY).

CPACK_RPM_GENERATE_USER_BINARY_SPECFILE_TEMPLATE

Spec file template.

  • Mandatory : NO
  • Default : -

If set CPack will generate a template for USER specified binaryspec file and stop with an error. For example launch CPack like this:

The user may then use this file in order to hand-craft is ownbinary spec file which may be used withCPACK_RPM_USER_BINARY_SPECFILE.

CPACK_RPM_PRE_INSTALL_SCRIPT_FILE
CPACK_RPM_PRE_UNINSTALL_SCRIPT_FILE

Path to file containing pre (un)install script.

  • Mandatory : NO
  • Default : -

May be used to embed a pre (un)installation script in the spec file.The referred script file (or both) will be read and directlyput after the %pre or %preun sectionIf CPACK_RPM_COMPONENT_INSTALL is set to ON the (un)installscript for each component can be overridden withCPACK_RPM_<COMPONENT>_PRE_INSTALL_SCRIPT_FILE andCPACK_RPM_<COMPONENT>_PRE_UNINSTALL_SCRIPT_FILE.One may verify which scriptlet has been included with:

CPACK_RPM_POST_INSTALL_SCRIPT_FILE
CPACK_RPM_POST_UNINSTALL_SCRIPT_FILE

Path to file containing post (un)install script.

  • Mandatory : NO
  • Default : -

May be used to embed a post (un)installation script in the spec file.The referred script file (or both) will be read and directlyput after the %post or %postun section.If CPACK_RPM_COMPONENT_INSTALL is set to ON the (un)installscript for each component can be overridden withCPACK_RPM_<COMPONENT>_POST_INSTALL_SCRIPT_FILE andCPACK_RPM_<COMPONENT>_POST_UNINSTALL_SCRIPT_FILE.One may verify which scriptlet has been included with:

CPACK_RPM_USER_FILELIST
CPACK_RPM_<COMPONENT>_USER_FILELIST_USER_FILELIST'>¶
  • Mandatory : NO
  • Default : -

May be used to explicitly specify %(<directive>) file linein the spec file. Like %config(noreplace) or any other directivethat be found in the %files section. Since CPackRPM is generatingthe list of files (and directories) the user specified files ofthe CPACK_RPM_<COMPONENT>_USER_FILELIST list will be removed fromthe generated list.

CPACK_RPM_CHANGELOG_FILE

RPM changelog file.

  • Mandatory : NO
  • Default : -

May be used to embed a changelog in the spec file.The referred file will be read and directly put after the %changelogsection.

CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST

list of path to be excluded.

  • Mandatory : NO
  • Default : /etc /etc/init.d /usr /usr/share /usr/share/doc /usr/bin /usr/lib /usr/lib64 /usr/include

May be used to exclude path (directories or files) from the auto-generatedlist of paths discovered by CPack RPM. The defaut value contains areasonable set of values if the variable is not defined by the user. If thevariable is defined by the user then CPackRPM will NOT any of the defaultpath. If you want to add some path to the default list then you can useCPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION variable.

CPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST_ADDITION

additional list of path to be excluded.

  • Mandatory : NO
  • Default : -

May be used to add more exclude path (directories or files) from the initialdefault list of excluded paths. SeeCPACK_RPM_EXCLUDE_FROM_AUTO_FILELIST.

CPACK_RPM_RELOCATION_PATHS

Packages relocation paths list.

  • Mandatory : NO
  • Default : -

May be used to specify more than one relocation path per relocatable RPM.Variable contains a list of relocation paths that if relative are prefixedby the value of _PACKAGE_PREFIX'>CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX or by thevalue of CPACK_PACKAGING_INSTALL_PREFIX if the component versionis not provided.Variable is not component based as its content can be used to set a differentpath prefix for e.g. binary dir and documentation dir at the same time.Only prefixes that are required by a certain component are added to thatcomponent - component must contain at least one file/directory/symbolic linkwith CPACK_RPM_RELOCATION_PATHS prefix for a certain relocationpath to be added. Package will not contain any relocation paths if there areno files/directories/symbolic links on any of the provided prefix locations.Packages that either do not contain any relocation paths or containfiles/directories/symbolic links that are outside relocation paths printout an AUTHOR_WARNING that RPM will be partially relocatable.

CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX_PACKAGE_PREFIX'>¶

Per component relocation path install prefix.

  • Mandatory : NO
  • Default : CPACK_PACKAGING_INSTALL_PREFIX

May be used to set per component CPACK_PACKAGING_INSTALL_PREFIXfor relocatable RPM packages.

CPACK_RPM_NO_INSTALL_PREFIX_RELOCATION
CPACK_RPM_NO_<COMPONENT>_INSTALL_PREFIX_RELOCATION_INSTALL_PREFIX_RELOCATION'>¶

Removal of default install prefix from relocation paths list.

  • Mandatory : NO
  • Default :CPACK_PACKAGING_INSTALL_PREFIX or CPACK_RPM_<COMPONENT>_PACKAGE_PREFIX
    are treated as one of relocation paths

May be used to remove CPACK_PACKAGING_INSTALL_PREFIX and CPACK_RPM_<COMPONENT>_PACKAGE_PREFIXfrom relocatable RPM prefix paths.

CPACK_RPM_ADDITIONAL_MAN_DIRS
  • Mandatory : NO
  • Default : -

May be used to set additional man dirs that could potentially be compressedby brp-compress RPM macro. Variable content must be a list of regularexpressions that point to directories containing man files or to man filesdirectly. Note that in order to compress man pages a path must also bepresent in brp-compress RPM script and that brp-compress script must beadded to RPM configuration by the operating system.

Regular expressions that are added by default were taken from brp-compressRPM macro:

  • /usr/man/man.*
  • /usr/man/.*/man.*
  • /usr/info.*
  • /usr/share/man/man.*
  • /usr/share/man/.*/man.*
  • /usr/share/info.*
  • /usr/kerberos/man.*
  • /usr/X11R6/man/man.*
  • /usr/lib/perl5/man/man.*
  • /usr/share/doc/.*/man/man.*
  • /usr/lib/.*/man/man.*
CPACK_RPM_DEFAULT_USER
CPACK_RPM_<compName>_DEFAULT_USER_DEFAULT_USER'>¶

default user ownership of RPM content

  • Mandatory : NO
  • Default : root

Value should be user name and not UID.Note that <compName> must be in upper-case.

CPACK_RPM_DEFAULT_GROUP
CPACK_RPM_<compName>_DEFAULT_GROUP_DEFAULT_GROUP'>¶

default group ownership of RPM content

  • Mandatory : NO
  • Default : root

Value should be group name and not GID.Note that <compName> must be in upper-case.

CPACK_RPM_DEFAULT_FILE_PERMISSIONS
CPACK_RPM_<compName>_DEFAULT_FILE_PERMISSIONS_DEFAULT_FILE_PERMISSIONS'>¶

default permissions used for packaged files

  • Mandatory : NO
  • Default : - (system default)

Accepted values are lists with PERMISSIONS. Valid permissionsare:

  • OWNER_READ
  • OWNER_WRITE
  • OWNER_EXECUTE
  • GROUP_READ
  • GROUP_WRITE
  • GROUP_EXECUTE
  • WORLD_READ
  • WORLD_WRITE
  • WORLD_EXECUTE

Note that <compName> must be in upper-case.

CPACK_RPM_DEFAULT_DIR_PERMISSIONS
CPACK_RPM_<compName>_DEFAULT_DIR_PERMISSIONS_DEFAULT_DIR_PERMISSIONS'>¶

default permissions used for packaged directories

  • Mandatory : NO
  • Default : - (system default)

Accepted values are lists with PERMISSIONS. Valid permissionsare the same as for CPACK_RPM_DEFAULT_FILE_PERMISSIONS.Note that <compName> must be in upper-case.

Packaging of Symbolic Links¶

CPackRPM supports packaging of symbolic links:

Symbolic links will be optimized (paths will be shortened if possible)before being added to the package or if multiple relocation paths aredetected, a post install symlink relocation script will be generated.

Symbolic links may point to locations that are not packaged by the samepackage (either a different component or even not packaged at all) butthose locations will be treated as if they were a part of the packagewhile determining if symlink should be either created or present in apost install script - depending on relocation paths.

Symbolic links that point to locations outside packaging path produce awarning and are treated as non relocatable permanent symbolic links.

Currently there are a few limitations though:

  • For component based packaging component interdependency is not checkedwhen processing symbolic links. Symbolic links pointing to content ofa different component are treated the same way as if pointing to locationthat will not be packaged.
  • Symbolic links pointing to a location through one or more intermediatesymbolic links will not be handled differently - if the intermediatesymbolic link(s) is also on a relocatable path, relocating it duringpackage installation may cause initial symbolic link to point to aninvalid location.

Packaging of debug information¶

Debuginfo packages contain debug symbols and sources for debugging packagedbinaries.

Note

Currently multiple debuginfo packages are generated if component basedpackaging is used - one debuginfo package per component. This duplicatessources if multiple binaries are using them. This is a side effect ofhow CPackRPM currently generates component packages and will be addressedin later versions of the generator.

Debuginfo RPM packaging has it’s own set of variables:

CPACK_RPM_DEBUGINFO_PACKAGE
CPACK_RPM_<component>_DEBUGINFO_PACKAGE_DEBUGINFO_PACKAGE'>¶

Enable generation of debuginfo RPM package(s).

  • Mandatory : NO
  • Default : OFF

Note

Binaries must contain debug symbols before packaging so use either Debugor RelWithDebInfo for CMAKE_BUILD_TYPE variable value.

Note

Packages generated from packages without binary files, with binary files butwithout execute permissions or without debug symbols will be empty.

CPACK_BUILD_SOURCE_DIRS

Provides locations of root directories of source files from which binarieswere built.

  • Mandatory : YES if CPACK_RPM_DEBUGINFO_PACKAGE is set
  • Default : -

Note Native instruments tnt free version download for mac.

For CMake project CPACK_BUILD_SOURCE_DIRS is set by default topoint to CMAKE_SOURCE_DIR and CMAKE_BINARY_DIR paths.

Note

Sources with path prefixes that do not fall under any location provided withCPACK_BUILD_SOURCE_DIRS will not be present in debuginfo package.

CPACK_RPM_BUILD_SOURCE_DIRS_PREFIX
CPACK_RPM_<component>_BUILD_SOURCE_DIRS_PREFIX_BUILD_SOURCE_DIRS_PREFIX'>¶

Prefix of location where sources will be placed during package installation.

  • Mandatory : YES if CPACK_RPM_DEBUGINFO_PACKAGE is set
  • Default :“/usr/src/debug/<CPACK_PACKAGE_FILE_NAME>” and
    for component packaging “/usr/src/debug/<CPACK_PACKAGE_FILE_NAME>-<component>”

Note

Each source path prefix is additionaly suffixed by src_<index> whereindex is index of the path used from CPACK_BUILD_SOURCE_DIRSvariable. This produces <CPACK_RPM_BUILD_SOURCE_DIRS_PREFIX>/src_<index>replacement path.Limitation is that replaced path part must be shorter or of equallength than the length of its replacement. If that is not the case eitherCPACK_RPM_BUILD_SOURCE_DIRS_PREFIX variable has to be set toa shorter path or source directories must be placed on a longer path.

CPACK_RPM_DEBUGINFO_EXCLUDE_DIRS

Directories containing sources that should be excluded from debuginfo packages.

  • Mandatory : NO
  • Default : “/usr /usr/src /usr/src/debug”

Listed paths are owned by other RPM packages and should therefore not bedeleted on debuginfo package uninstallation.

CPACK_RPM_DEBUGINFO_EXCLUDE_DIRS_ADDITION

Paths that should be appended to CPACK_RPM_DEBUGINFO_EXCLUDE_DIRSfor exclusion.

  • Mandatory : NO
  • Default : -

Packaging of sources (SRPM)¶

SRPM packaging is enabled by setting CPACK_RPM_PACKAGE_SOURCESvariable while usually using CPACK_INSTALLED_DIRECTORIES variableto provide directory containing CMakeLists.txt and source files.

For CMake projects SRPM package would be product by executing:

cpack-GRPM--config./CPackSourceConfig.cmake

Note

Produced SRPM package is expected to be built with cmake(1) executableand packaged with cpack(1) executable so CMakeLists.txt has to belocated in root source directory and must be able to generate binary rpmpackages by executing cpack-G command. The two executables as well asrpmbuild must also be present when generating binary rpm packages from theproduced SRPM package.

Once the SRPM package is generated it can be used to generate binary packagesby creating a directory structure for rpm generation and executing rpmbuildtool:

mkdir-pbuild_dir/{BUILD,BUILDROOT,RPMS,SOURCES,SPECS,SRPMS}rpmbuild--define'_topdir<path_to_build_dir>'--rebuild<SRPM_file_name>

Generated packages will be located in build_dir/RPMS directory or its subdirectories.

Note

SRPM package internally uses CPack/RPM generator to generate binary packagesso CMakeScripts.txt can decide during the SRPM to binary rpm generation stepwhat content the package(s) should have as well as how they should be packaged(monolithic or components). CMake can decide this for e.g. by reading environmentvariables set by the package manager before starting the process of generatingbinary rpm packages. This way a single SRPM package can be used to producedifferent binary rpm packages on different platforms depending on the platform’spackaging rules.

Source RPM packaging has it’s own set of variables:

CPACK_RPM_PACKAGE_SOURCES

Should the content be packaged as a source rpm (default is binary rpm).

  • Mandatory : NO
  • Default : OFF

Note

For cmake projects CPACK_RPM_PACKAGE_SOURCES variable is setto OFF in CPackConfig.cmake and ON in CPackSourceConfig.cmakegenerated files.

CPACK_RPM_SOURCE_PKG_BUILD_PARAMS

Additional command-line parameters provided to cmake(1) executable.

  • Mandatory : NO
  • Default : -
CPACK_RPM_SOURCE_PKG_PACKAGING_INSTALL_PREFIX

Packaging install prefix that would be provided in CPACK_PACKAGING_INSTALL_PREFIXvariable for producing binary RPM packages.

  • Mandatory : YES
  • Default : “/”

Variables specific to CPack RPM generatorCPackRPM may be used to create RPM packages using.CPackRPM is a generator thus it uses the CPACKXXXvariables used by.CPackRPM has specific features which are controlled by the specificsCPACKRPMXXX variables.CPACKRPMXXXX variables may be used in order to havecomponent specific values. Note however that refers to thegrouping name written in upper case. It may be either a component name ora component GROUP name. Usually those variables correspond to RPM spec fileentities. One may find information about spec files here.

Note part of variables is preferred to be in upper case (for e.g. Ifcomponent is named foo then use CPACKRPMFOOXXXX variable name format)as is with other CPACKXXXX variables.For the purposes of back compatibility (CMake/CPack version 3.5 and lower)support for same cased component (e.g. FOo would be used asCPACKRPMfOoXXXX) is still supported for variables defined in olderversions of CMake/CPack but is not guaranteed for variables thatwill be added in the future. For the sake of back compatibility same casedcomponent variables also override upper cased versions where both arepresent.Here are some CPackRPM wiki resources that are here for historic reasons andare no longer maintained but may still prove useful.List of CPackRPM specific variables: CPACKRPMCOMPONENTINSTALLEnable component packaging for CPackRPM. Mandatory: NO. Default: OFFIf enabled (ON) multiple packages are generated. By default a single packagecontaining files of all components is generated.

CPACKRPMPACKAGESUMMARY CPACKRPMPACKAGESUMMARYThe RPM package summary. Mandatory: YES. Default:CPACKRPMPACKAGENAME CPACKRPMPACKAGENAMEThe RPM package name. Mandatory: YES.

Default:CPACKRPMFILENAME CPACKRPMFILENAMEPackage file name.Mandatory: YES. Default: -.rpm with spacesreplaced by ‘-‘This may be set to RPM-DEFAULT to allow rpmbuild tool to generate packagefile name by itself.Alternatively provided package file name must end with.rpm suffix. NoteBy using user provided spec file, rpm macro extensions such as forgenerating debuginfo packages or by simply using multiple components morethan one rpm file may be generated, either from a single spec file or frommultiple spec files (each component execution produces it’s own spec file).In such cases duplicate file names may occur as a result of this variablesetting or spec file content structure. Duplicate files get overwrittenand it is up to the packager to set the variables in a manner that willprevent such errors. CPACKRPMPACKAGEVERSIONThe RPM package version. Mandatory: YES.

Default:CPACKRPMPACKAGEARCHITECTURE CPACKRPMPACKAGEARCHITECTUREThe RPM package architecture. Mandatory: YES. Default: Native architecture output by uname -mThis may be set to noarch if you know you are building a noarch package. CPACKRPMPACKAGERELEASEThe RPM package release. Mandatory: YES. Default: 1This is the numbering of the RPM package itself, i.e.

The version of thepackaging and not the version of the content (see). One may change the default value ifthe previous packaging was buggy and/or you want to put here a fancy Linuxdistro specific numbering. Set ( CPACKRPMPACKAGEREQUIRESPREUN 'shadow-utils, initscripts' ) CPACKRPMPACKAGESUGGESTS CPACKRPMPACKAGESUGGESTSRPM spec suggest field. Mandatory: NO. Default: -May be used to set weak RPM dependencies (suggests).

Note that you mustenclose the complete requires string between quotes. CPACKRPMPACKAGEPROVIDES CPACKRPMPACKAGEPROVIDESRPM spec provides field.

Mandatory: NO. Default: -May be used to set RPM dependencies (provides). The provided package listof an RPM file could be printed with. Rpm - prefix or - relocatein order to install it at an alternate place see rpm(8). Note thatcurrently this may fail if is set to ON.

Ifis set then you will get a warning message butif there is file installed with absolute path you’ll get unexpected behavior. CPACKRPMSPECINSTALLPOSTDeprecated - use instead. Mandatory: NO. Default: -.

Deprecated: YESThis way of specifying post-install script is deprecated, use.May be used to set an RPM post-install command inside the spec file.For example setting it to /bin/true may be used to preventrpmbuild to strip binaries. CPACKRPMSPECMOREDEFINERPM extended spec definitions lines. Mandatory: NO.

Default: -May be used to add any%define lines to the generated spec file. CPACKRPMPACKAGEDEBUGToggle CPackRPM debug output. Mandatory: NO. Default: -May be set when invoking cpack in order to trace debug informationduring CPack RPM run. For example you may launch CPack like this. Cpack - D CPACKRPMPACKAGEDEBUG = 1 - G RPM CPACKRPMUSERBINARYSPECFILE CPACKRPMUSERBINARYSPECFILEA user provided spec file. Mandatory: NO.

Default: -May be set by the user in order to specify a USER binary spec fileto be used by CPackRPM instead of generating the file.The specified file will be processed by configurefile( @ONLY). CPACKRPMGENERATEUSERBINARYSPECFILETEMPLATESpec file template. Mandatory: NO. Default: -If set CPack will generate a template for USER specified binaryspec file and stop with an error.

For example launch CPack like this. Cpack - D CPACKRPMGENERATEUSERBINARYSPECFILETEMPLATE = 1 - G RPMThe user may then use this file in order to hand-craft is ownbinary spec file which may be used with. CPACKRPMPREINSTALLSCRIPTFILE CPACKRPMPREUNINSTALLSCRIPTFILEPath to file containing pre (un)install script. Mandatory: NO. Default: -May be used to embed a pre (un)installation script in the spec file.The referred script file (or both) will be read and directlyput after the%pre or%preun sectionIf is set to ON the (un)installscript for each component can be overridden withCPACKRPMPREINSTALLSCRIPTFILE andCPACKRPMPREUNINSTALLSCRIPTFILE.One may verify which scriptlet has been included with. Rpm - qp - scripts package. Rpm CPACKRPMPOSTINSTALLSCRIPTFILE CPACKRPMPOSTUNINSTALLSCRIPTFILEPath to file containing post (un)install script.

Mandatory: NO. Default: -May be used to embed a post (un)installation script in the spec file.The referred script file (or both) will be read and directlyput after the%post or%postun section.If is set to ON the (un)installscript for each component can be overridden withCPACKRPMPOSTINSTALLSCRIPTFILE andCPACKRPMPOSTUNINSTALLSCRIPTFILE.One may verify which scriptlet has been included with. Rpm - qp - scripts package.

Rpm CPACKRPMUSERFILELIST CPACKRPMUSERFILELIST. Mandatory: NO. Default: -May be used to explicitly specify% file linein the spec file. Like%config(noreplace) or any other directivethat be found in the%files section.

Since CPackRPM is generatingthe list of files (and directories) the user specified files ofthe CPACKRPMUSERFILELIST list will be removed fromthe generated list. CPACKRPMCHANGELOGFILERPM changelog file. Mandatory: NO. Default: -May be used to embed a changelog in the spec file.The referred file will be read and directly put after the%changelogsection. CPACKRPMEXCLUDEFROMAUTOFILELISTlist of path to be excluded. Mandatory: NO.

Default: /etc /etc/init.d /usr /usr/share /usr/share/doc /usr/bin /usr/lib /usr/lib64 /usr/includeMay be used to exclude path (directories or files) from the auto-generatedlist of paths discovered by CPack RPM. The defaut value contains areasonable set of values if the variable is not defined by the user. If thevariable is defined by the user then CPackRPM will NOT any of the defaultpath.

If you want to add some path to the default list then you can usevariable. CPACKRPMEXCLUDEFROMAUTOFILELISTADDITIONadditional list of path to be excluded. Mandatory: NO. Default: -May be used to add more exclude path (directories or files) from the initialdefault list of excluded paths. CPACKRPMRELOCATIONPATHSPackages relocation paths list.

Mandatory: NO. Default: -May be used to specify more than one relocation path per relocatable RPM.Variable contains a list of relocation paths that if relative are prefixedby the value of or by thevalue of if the component versionis not provided.Variable is not component based as its content can be used to set a differentpath prefix for e.g. Binary dir and documentation dir at the same time.Only prefixes that are required by a certain component are added to thatcomponent - component must contain at least one file/directory/symbolic linkwith prefix for a certain relocationpath to be added. Package will not contain any relocation paths if there areno files/directories/symbolic links on any of the provided prefix locations.Packages that either do not contain any relocation paths or containfiles/directories/symbolic links that are outside relocation paths printout an AUTHORWARNING that RPM will be partially relocatable. CPACKRPMPACKAGEPREFIXPer component relocation path install prefix. Mandatory: NO. Default: CPACKPACKAGINGINSTALLPREFIXMay be used to set per componentfor relocatable RPM packages.

CPACKRPMNOINSTALLPREFIXRELOCATION CPACKRPMNOINSTALLPREFIXRELOCATIONRemoval of default install prefix from relocation paths list. Mandatory: NO. Default: CPACKPACKAGINGINSTALLPREFIX or CPACKRPMPACKAGEPREFIX are treated as one of relocation pathsMay be used to remove CPACKPACKAGINGINSTALLPREFIX and CPACKRPMPACKAGEPREFIXfrom relocatable RPM prefix paths.

CPACKRPMADDITIONALMANDIRS. Mandatory: NO. Default: -May be used to set additional man dirs that could potentially be compressedby brp-compress RPM macro. Variable content must be a list of regularexpressions that point to directories containing man files or to man filesdirectly. NoteCurrently multiple debuginfo packages are generated if component basedpackaging is used - one debuginfo package per component. This duplicatessources if multiple binaries are using them.

This is a side effect ofhow CPackRPM currently generates component packages and will be addressedin later versions of the generator.Debuginfo RPM packaging has it’s own set of variables: CPACKRPMDEBUGINFOPACKAGE CPACKRPMDEBUGINFOPACKAGEEnable generation of debuginfo RPM package(s). Mandatory: NO. Default: OFF. NoteEach source path prefix is additionaly suffixed by src whereindex is index of the path used fromvariable. This produces /srcreplacement path.Limitation is that replaced path part must be shorter or of equallength than the length of its replacement. If that is not the case eithervariable has to be set toa shorter path or source directories must be placed on a longer path. CPACKRPMDEBUGINFOEXCLUDEDIRSDirectories containing sources that should be excluded from debuginfo packages.

Mandatory: NO. Default: “/usr /usr/src /usr/src/debug”Listed paths are owned by other RPM packages and should therefore not bedeleted on debuginfo package uninstallation.

CPACKRPMDEBUGINFOEXCLUDEDIRSADDITIONPaths that should be appended tofor exclusion. Mandatory: NO.

Default. NoteSRPM package internally uses CPack/RPM generator to generate binary packagesso CMakeScripts.txt can decide during the SRPM to binary rpm generation stepwhat content the package(s) should have as well as how they should be packaged(monolithic or components). CMake can decide this for e.g. By reading environmentvariables set by the package manager before starting the process of generatingbinary rpm packages.

This way a single SRPM package can be used to producedifferent binary rpm packages on different platforms depending on the platform’spackaging rules.Source RPM packaging has it’s own set of variables: CPACKRPMPACKAGESOURCESShould the content be packaged as a source rpm (default is binary rpm). Mandatory: NO. Default: OFF.