CMake-3.31.1

Introduction to CMake

The CMake package contains a modern toolset used for generating Makefiles. It is a successor of the auto-generated configure script and aims to be platform- and compiler-independent. A significant user of CMake is KDE since version 4.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

  • Download (HTTP): https://cmake.org/files/v3.31/cmake-3.31.1.tar.gz

  • Download MD5 sum: cd514031819f03fad11f56730dc8aa33

  • Download size: 12 MB

  • Estimated disk space required: 462 MB (add 1.3 GB for tests)

  • Estimated build time: 2.0 SBU (add 4.0 SBU for tests, both using parallelism=4)

CMake Dependencies

Recommended

Optional

GCC-14.2.0 (for gfortran), git-2.47.1 (for use during tests), Mercurial-6.9 (for use during tests), OpenJDK-23.0.1 (for use during tests), Qt-6.8.0 (for the Qt-based GUI), sphinx-8.1.3 (for building documents), Subversion-1.14.4 (for testing), cppdap, jsoncpp, and rhash

Installation of CMake

Install CMake by running the following commands:

sed -i '/"lib64"/s/64//' Modules/GNUInstallDirs.cmake &&

./bootstrap --prefix=/usr        \
            --system-libs        \
            --mandir=/share/man  \
            --no-system-jsoncpp  \
            --no-system-cppdap   \
            --no-system-librhash \
            --docdir=/share/doc/cmake-3.31.1 &&
make

To test the results, issue: bin/ctest -j$(nproc). Replace $(nproc) with an integer between 1 and the number of system logical cores if you don't want to use all.

If you want to investigate a problem with a given "problem1-test", use bin/ctest -R "problem1-test" and, to omit it, use bin/ctest -E "problem1-test". These options can be used together: bin/ctest -R "problem1-test" -E "problem2-test". Option -N can be used to display all available tests, and you can run bin/ctest for a sub-set of tests by using separated by spaces names or numbers as options. Option --help can be used to show all options.

Now, as the root user:

make install

Command Explanations

sed ... Modules/GNUInstallDirs.cmake: This command disables applications using cmake from attempting to install files in /usr/lib64/.

--system-libs: This switch forces the build system to link against the system installed version for all needed libraries but those explicitly specified via a --no-system-* option.

--no-system-jsoncpp and --no-system-cppdap: These switches remove the JSON-C++ library from the list of system libraries. A bundled version of that library is used instead.

--no-system-librhash: This switch removes the librhash library from the list of system libraries used. A bundled version of that library is used instead.

--no-system-{curl,libarchive,libuv,nghttp2}: Use the corresponding option in the list for the bootstrap if one of the recommended dependencies is not installed. A bundled version of the dependency will be used instead.

--qt-gui: This switch enables building the Qt-based GUI for CMake.

--parallel=: This switch enables performing the CMake bootstrap with multiple jobs at one time. It's not needed if the MAKEFLAGS variable has been already set for using multiple processors following Using Multiple Processors.

Contents

Installed Programs: ccmake, cmake, cmake-gui (optional), cpack, and ctest
Installed Libraries: None
Installed Directories: /usr/share/cmake-3.31 and /usr/share/doc/cmake-3.31.1

Short Descriptions

ccmake

is a curses based interactive frontend to cmake

cmake

is the makefile generator

cmake-gui

(optional) is the Qt-based frontend to cmake

cpack

is the CMake packaging program

ctest

is a testing utility for cmake-generated build trees