88
cmake --build . --config Release

Is it possible to set the number of cores to be used by the build process?

I'm looking for something similar to GNU make's -j option.

1

2 Answers 2

102

According to the Release Notes, with CMake 3.12 it can be done cross-platform:

The cmake(1) Build Tool Mode (cmake –build) gained --parallel [<jobs>] and -j [<jobs>] options to specify a parallel build level. They map to corresponding options of the native build tool.

84

You can pass arbitrary arguments to the native build tool with --. Everything after -- will be passed to the build tool. To pass -j 3 in your example, just use

cmake --build . --config Release -- -j 3

Documentation: https://cmake.org/cmake/help/v3.5/manual/cmake.1.html

You could also use Ninja as a build tool, it uses automatically an appropriate number of threads. Or you can modify the make command by defining CMAKE_MAKE_PROGRAM="make -j 3. But this is a rather hacky workaround.

11
  • 5
    Is there an build-tool independent way to do this?
    – Knitschi
    May 5, 2016 at 10:52
  • 2
    No, everything after -- is passed to the build tool. Maybe your build tools accept the same options, but in general I doubt that.
    – usr1234567
    May 5, 2016 at 10:53
  • 2
    Both Windows (cmake 3.7) and Ubuntu (cmake 3.9) report that -j is not an option. Am I doing something wrong?
    – Matt
    Jan 22, 2018 at 14:31
  • 2
    My experience using -j on Ubuntu Bash on Windows: The higher the thread limit, the more random compilation errors about missing files I get. This does not seem to work perfectly with make on Windows.
    – mattmilten
    Jun 13, 2018 at 20:56
  • 1
    @Knitschi With CMake 3.12 and newer there is a way, see my other answer stackoverflow.com/a/50883555/2799037
    – usr1234567
    Feb 27, 2020 at 9:50

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.