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.