Sun Studio 12: Distributed Make (dmake)

Options

-c dmake_rcfile

Specifies an alternate runtime configuration file.

The default runtime configuration file is $(HOME)/.dmakerc.

-g dmake_group

Specifies the name of the build server group to which jobs are distributed.

You define server groups in the runtime configuration file.

The default server group is the first group in the runtime configuration file.

-j dmake_max_jobs

Specifies the maximum total number of jobs that are distributed to the specified group of build servers in the runtime configuration file.

The default maximum number of jobs is the sum of all the specified jobs in a build server group.

The jobs are subtracted from, or added to, hosts by 1 in the order they appear in the runtime configuration file.

For example, if all jobs specified in the runtime configuration file total 8:


host earth { jobs = 3 }
host mars  { jobs = 5 }

and dmake_max_jobs is specified as 11, dmake adds three more jobs to the current total maximum number of jobs (which is eight) as follows:


host earth { jobs = 5 }
host mars  { jobs = 6 }

Also, if dmake_max_jobs is specified as 4, dmake subtracts four jobs (from the original eight) as follows:


host earth { jobs = 1 }
host mars  { jobs = 3 }

-m {serial | parallel | distributed}

Specify one of the following key words:

-o dmake_odir

Specifies a common physical directory that dmake can write temporary output files to and read temporary output files from. The directory used is $(HOME)/.dmake and this or whichever directory is specified, must be visible to all build servers.

Use this option only if the $(HOME) directory on your local host and the $(HOME) directory on all of your remote hosts are not the same physical $(HOME) directory.

For example, a root user would use this option.


Note –

These options and the environment variables and makefile macros described later in this man page modify the same behavior.


Their order of precedence is defined as: