Build Catalyst environment variables

Build Catalyst supports several environment variables to simplify usage.

The variables are grouped by operating system in the following sections:

Environment variables that are common to Linux, Solaris, and Microsoft Windows

RAFMAKE_CONC
Sets the concurrency level in a rafmake build. This variable takes the same values as the –J option. Specifying the –J option when you use the rafmake command overrides the setting of this variable.
RAFMAKE_COMPAT
Specifies a rafmake command compatibility mode. This variable takes the same values as the –c option. Specifying the –c option when you use the rafmake command overrides the setting of this variable.

Default: None

RAFMAKE_MAKEFLAGS
Provides an alternative or supplementary mechanism for specifying rafmake command options. The RAFMAKE_MAKEFLAGS environment variable can contain the same string of key letters that is used for command-line options, except that options that take arguments are not valid. Options you specify on the rafmake command line override the setting of this environment variable if there is a conflict.

Default: None

RAFMAKE_OPTS_SPECS
Provides a list of path names, separated by colons (Linux and Solaris) or semicolons (Windows), each of which specifies a build option specification (BOS) file that the rafmake command reads. You can use this variable instead of specifying BOS files on the rafmake command line with one or more –A options.

Default: Undefined

RAFMAKE_SHELL_FLAGS
Specifies rafmake command options to pass to the subshell program that runs a build script command.

Default:

  • Linux and Solaris: –e
  • Windows: None
RAFMAKE_SHELL_REQUIRED
Forces the rafmake command to run build scripts in the shell program that you specify with the SHELL macro. To make the rafmake command run build scripts in the shell program, set this variable to TRUE. To configure the rafmake command to run build scripts directly, unset the variable.

Default: The rafmake command runs build scripts directly

RAFMAKE_VERBOSITY
Specifies the rafmake command message logging level as follows:
1
Equivalent to –v (verbose) on the command line
2
Equivalent to –d (debug) on the command line
0 or undefined
Equivalent to standard message logging level

If you also specify –v or –d on the command line, the higher value prevails.

Default: 0

MAKEFLAGS

Lists one or more flags to pass to the make command. The rafmake command reads the contents of the MAKEFLAGS environment variable at startup. Then the command amends the variable to include flags that are not specific to Build Catalyst that are passed on the command line. Flags that are specific to Build Catalyst are passed through the RAFMAKE_MAKEFLAGS environment variable, and if the rafmake command detects these flags in the MAKEFLAGS variable, the command moves them to the RAFMAKE_MAKEFLAGS variable.

Flags passed through the MAKEFLAGS variable are as follows: -I, -p, -N, -w, -e, -r, -i, -k, -n, -q, -s

Flags passed through the RAFMAKE_MAKEFLAGS variable are as follows: -A, -B, -N, -v, -c, -U, -M, -u, -d

Default: None

Environment variables for Linux and Solaris only

RAFMAKE_BLD_HOSTS
Specifies one or more build hosts on which the rafmake command can build targets.

Default: Undefined

RAFMAKE_HOST_TYPE

Determines the name of the build hosts file to use during a parallel build (–J option): .bldhost.$RAFMAKE_HOST_TYPE in your home directory. (Your home directory is determined by examining the password database.)

Specifying a –B option on the command line overrides the setting of this variable.

C Shell Users: Set this variable in the .cshrc file, not in the .login file. The parallel build facility calls a remote shell, which does not read the .login file.

You can also code RAFMAKE_HOST_TYPE as a make macro.

Default: None

Environment variables for Windows only

RAFMAKE_NO_ESC_PATT_CHARS
Overrides the escape character (\) in the rafmake command's GNU-compatible mode. For example, both the rafmake and GNU make commands assume that the \% string indicates the literal character, %. The commands do not treat the rule as a pattern rule. To prevent the rafmake command from using the escape character to indicate a literal character, set this environment variable to any non-null value.
RAFMAKE_PNAME_SEP
Sets the path-name separator for path names that the rafmake command constructs. This variable can be set in the makefile, in a BOS file, on the command line, or as an environment variable.

Default: If this variable is not set or is set to any value other than a forward slash (/) or a backslash (\), the rafmake command uses a backslash (\) as the path-name separator.


Feedback