Build Catalyst examples

Use these examples to better understand how you can use Build Catalyst for simple builds, parallel builds, and distributed builds.

Simple builds

For simple builds (builds that are not parallel or distributed), run the rafmake command as follows:

rafmake [ -f makefile ] [ options ] ... [ targets ] ... 
where

The following list provides examples by operating system.

Parallel builds

The rafmake command supports parallel builds, which separate builds into independent components that can be built at the same time to reduce the overall build time.

The syntax to run parallel builds is as follows:

rafmake -J num [ -f makefile ] [ options ] ... [ targets ] ... 
where

Running parallel builds provides efficient resource utilization, especially with multicore processors. The performance gain from parallel builds depends on the type of the build. For example, in the case of a CPU-intensive build, the optimum number of concurrent build jobs would be the same as the number of processors (or cores). If you specify more than that, you might not realize a significant performance gain. For an IO-intensive build, however, increasing the number of parallel jobs reduces build time. Try a few builds with different numbers to determine the optimal number of concurrent build jobs for your resources.

The following list provides examples of parallel builds by operating system.

Distributed builds

Parallel builds can use resources only on one computer. Distributing a build takes parallel builds a step further by distributing the build load across multiple computers.

Note: To use Build Catalyst for a distributed build, install it on all the computers that are used in the distributed build.

To distribute a build, your environment must meet the following requirements:


Feedback