Configuration Options

There are four ways to pass options to the configuration process.

1

Pass options individually in shell environment variables:

export <option name>=<chosen value> # for bash
setenv <option name> <chosen value> # for (t)csh
gmake <configuration name>-config

2a

Either: create a default configuration file ${HOME}/.cactus/config.

All available configuration options may be set in a default options file ${HOME}/.cactus/config, any option which is not set will take a default value. The file should contain lines of the form:

<option> [=] ...

The equals sign is optional. Spaces are allowed everywhere. Text starting wit a '#' character will be ignored as a comment.

2b

Or: list your Cactus configuration files in an environment variable CACTUS_CONFIG_FILES:

gmake <config name>-config CACTUS_CONFIG_FILES=4#4list of config files5#5

Multiple configuration files, with their file names separated by a ':' character, will be processed in order. Each file should be given by its full path. The options file has the same format as ${HOME}/.cactus/config.

3

Add the options to a configuration file and use,

gmake <config name>-config options=<filename>

The options file has the same format as ${HOME}/.cactus/config. (Note that these options are added to those from the ${HOME}/.cactus/config file.)

4

Pass the options individually on the command line,

gmake <config name>-config <option name>=<chosen value>, ...

Not all configuration options can be set on the command line. Those that can be set are indicated in the table below.

They are listed here in order of increasing precedence, e.g. options set on the command line will take priority over (potentially conflicting) options set in ${HOME}/.cactus/config or other Cactus configuration files. Default options from ${HOME}/.cactus/config will only be read if the environment variable CACTUS_CONFIG_FILES is not set.

It is important to note that these methods cannot be used to, for example, add options to the default values for CFLAGS. Setting any variable in the configuration file or the command line will overwrite completely the default values.